google_images
Retrieve Google Images search results with titles, thumbnails, source links, and original dimensions. Supports filters for size, color, type, date, and license.
Instructions
Retrieves Google Images search results including titles, thumbnails, source links, and original image dimensions. Each successful request costs 10 API credits. [Credits: 10 API credits per successful request] Notes: Time filtering: use either period_unit+period_value OR start_date/end_date, not both together with tbs's own date components (each overrides the corresponding tbs component). chips values are discovered from a prior response's suggested_searches array. Returns: { images_results: [{title, image, source, original, link, original_height, original_width, original_size, rank}] }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cr | No | Restrict search to specific countries, formatted country{2-letter uppercase code}, pipe-separated for multiple, e.g. countryFR|countryDE. | |
| lr | No | Limit search to one or multiple languages, formatted lang_{language code}. | |
| tbs | No | Advanced parameter ('to be searched') to filter search results. | |
| html | No | Return the full HTML of the Google Images page. (default: false) | |
| nfpr | No | Set 1 to exclude auto-corrected/misspelled-query results, 0 to include them. (default: 0) | |
| page | No | Page number of Google search results. 0 = first page, 1 = second page, etc. (default: 0) | |
| safe | No | Adult content filter. Allowed values: active, off. (default: off) | |
| uule | No | Encoded geographic location/locale to tailor results, e.g. w+CAIQIFJlbGF5IFN0YXRlcw==. | |
| chips | No | Filters results using a Google-suggested search term (e.g. 'red apple'). Suggested chips appear under suggested_searches in the response when ijn=0; each includes a chip value and a scrapingdog_link. | |
| imgar | No | Image aspect ratio filter. Allowed values: s (Square), t (Tall), w (Wide), xw (Panoramic). | |
| imgsz | No | Image size filter. Allowed values: l (Large), m (Medium), i (Icon), qsvga (>400x300), vga (>640x480), svga (>800x600), xga (>1024x768), 2mp, 4mp, 6mp, 8mp, 10mp, 12mp, 15mp, 20mp, 40mp, 70mp (Larger than N megapixels). | |
| query | Yes | Google Search query. Example: query=pizza | |
| domain | No | Google domain for local results, e.g. google.co.in for India, google.co.uk for the UK. (default: google.com) | |
| filter | No | Enables/disables the 'Similar Results' and 'Omitted Results' filters. 1 (default) activates filters, 0 turns them off. | |
| country | No | Two-letter country code for the Google search (e.g. US, UK, FR). (default: us) | |
| end_date | No | End date for the image search date range. Format YYYYMMDD, e.g. 20241231. Cannot be used with period_unit/period_value. If start_date is blank, includes all dates before end_date. Overrides cdr/cd_max in tbs. | |
| language | No | Language of the results, e.g. en, es, fr, de. (default: en) | |
| licenses | No | License filter. Allowed values: f (Free to use/share), fc (Free to use/share, even commercially), fm (Free to use/share/modify), fmc (Free to use/share/modify, even commercially), cl (Creative Commons), ol (Commercial and other licenses). Overrides the sur component of tbs. | |
| image_type | No | Image type filter. Allowed values: face, photo, clipart, lineart, animated. Overrides the itp component of tbs. | |
| start_date | No | Start date for the image search date range. Format YYYYMMDD, e.g. 20241201. Cannot be used with period_unit/period_value. If end_date is blank, range extends to today. Overrides cdr/cd_min in tbs. | |
| image_color | No | Image color filter. Allowed values: bw, trans, red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown. Overrides ic/isc components of tbs. | |
| period_unit | No | Time unit for retrieving recent images. Allowed values: s (Second), n (Minute), h (Hour), d (Day), w (Week), m (Month), y (Year). Cannot be used with start_date/end_date; takes precedence over the qdr component of tbs. | |
| period_value | No | Duration used with period_unit, e.g. 15 seconds, 42 hours, 178 days. Valid range 1 to 2,147,483,647. (default: 1) |