Search Photos
search_photosSearch Unsplash photos by keyword to find images for a specific topic or theme, with filters for color, orientation, and pagination. Results include attribution data required for compliant image use.
Instructions
Search for photos on Unsplash by keyword.
Use this tool when you need to find photos for a specific topic or theme. Each result includes full attribution data that MUST be displayed when using the image (required by Unsplash API guidelines).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_photos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (default: 1) | |
| color | No | Filter by color - black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue | |
| query | Yes | Search keyword(s), e.g. "mountain landscape", "coffee shop interior" | |
| order_by | No | Sort order - "relevant" (best match) or "latest" (newest first) | relevant |
| per_page | No | Number of results per page, 1-30 (default: 10) | |
| orientation | No | Filter by orientation - landscape, portrait, squarish | |
| content_filter | No | Safety filter - "low" (default) or "high" (stricter) | low |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |