image_search
Search for images using descriptive queries with filters for size, type, color, and format. Returns image URLs, thumbnails, and metadata.
Instructions
Find images by query with filters for size, type, color, and format. Returns JSON with fields: images (array of {title, link, thumbnailLink, displayLink, contextLink, width, height, fileSize}), query, resultCount. Results sorted by relevance; max 10 per call, no pagination. On no matches returns resultCount: 0 with empty array; on failure returns isError with message. Subject to per-tenant rate limit (default 30 req/min) with automatic provider fallback. Use this for visual assets or image references — not for text information. Use web_search for pages containing images, or scrape_page to extract images from a known URL. Results cached 30 min.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Descriptive search query for images (e.g. 'golden retriever puppy playing fetch'). More descriptive = better results.,required | |
| num_results | No | Number of image results (1-10, default: 5). | |
| size | No | Filter by image size: huge, icon, large, medium, small, xlarge, xxlarge. | |
| type | No | Filter by image type: clipart, face, lineart, stock, photo, animated. | |
| color_type | No | Filter by color mode: color, gray, mono, trans (transparent background). | |
| dominant_color | No | Filter by dominant color: black, blue, brown, gray, green, orange, pink, purple, red, teal, white, yellow. | |
| file_type | No | Filter by file format: jpg, gif, png, bmp, svg, webp. | |
| safe | No | SafeSearch level: off, medium (default), high. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| images | No | ||
| query | No | ||
| resultCount | No |