search_photos
Search high-quality images from Unsplash using keywords, filters, and pagination. Retrieve photo details like ID, description, URLs, and dimensions directly for integration into projects.
Instructions
Search for Unsplash photos
Args:
query: Search keyword
page: Page number (1-based)
per_page: Results per page (1-30)
order_by: Sort method (relevant or latest)
color: Color filter (black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue)
orientation: Orientation filter (landscape, portrait, squarish)
Returns:
List[UnsplashPhoto]: List of search results containing photo objects with the following properties:
- id: Unique identifier for the photo
- description: Optional text description of the photo
- urls: Dictionary of available image URLs in different sizes
- width: Original image width in pixels
- height: Original image height in pixels
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | No | ||
| order_by | No | relevant | |
| orientation | No | ||
| page | No | ||
| per_page | No | ||
| query | Yes |
Input Schema (JSON Schema)
{
"properties": {
"color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Color"
},
"order_by": {
"default": "relevant",
"title": "Order By",
"type": "string"
},
"orientation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Orientation"
},
"page": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"default": 1,
"title": "Page"
},
"per_page": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"default": 10,
"title": "Per Page"
},
"query": {
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"title": "search_photosArguments",
"type": "object"
}