Google Images Search
Search for image results on Google based on keywords.
If you already know that you want to use Google Images Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.
At a Glance
| Field | Value |
|---|---|
| Name | Google Images Search |
| Scraper | google_images |
| Engine | google_images_search |
| Website | |
| Website URL | googleimages.com |
| Output Format | json |
| Version | 1.0.0 |
| Parameter Count | 25 |
| Parameter Groups | Search Query (1), Localization (4), Pagination (2), Advanced Filters (10), Geographic Location (2), Request Controls (2), Time Period (4) |
Required Parameters
If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.
| Field | Type | Group | Description |
|---|---|---|---|
q | string | Search Query | The keyword or phrase you want this search engine to look up. |
Available Parameters
The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.
Search Query
| Field | Type | Required | Description |
|---|---|---|---|
q | string | Yes | The keyword or phrase you want this search engine to look up. |
Localization
| Field | Type | Required | Description |
|---|---|---|---|
cr | string | No | Limit results to one or more countries. |
gl | string | No | Country or region code used to localize the results. |
hl | string | No | Interface language used for the search and returned SERP labels. |
google_domain | string | No | Google domain to query, such as google.com or google.co.uk. |
Additional Constraints
gl：Default:us；Options: 244 options. Examples:af,al,dz,as,adhl：Default:en；Options: 157 options. Examples:af,ak,sq,ws,amgoogle_domain：Default:google.com；Options: 47 options. Examples:google.com,google.com.hk,google.co.uk,google.co.jp,google.us
Pagination
| Field | Type | Required | Description |
|---|---|---|---|
num | number | No | Requested number of results to return. |
start | number | No | Result offset used for Google-style pagination. |
Additional Constraints
num：Default:0start：Default:0
Advanced Filters
| Field | Type | Required | Description |
|---|---|---|---|
tbs | string | No | Advanced Google filter string, often used for time or content filters. |
nfpr | boolean | No | Try to turn off auto-corrected results and keep the original query. |
safe | number | No | Safe-search level that controls adult-content filtering. |
chips | string | No | Apply a Google suggested image refinement token. |
imgar | string | No | Filter images by aspect ratio. |
imgsz | string | No | Filter images by size or minimum resolution. |
filter | boolean | No | Turn similar-result or duplicate-result filtering on or off. |
licenses | string | No | Filter images by usage rights. |
image_type | string | No | Filter images by content type, such as photo, face, or clipart. |
image_color | string | No | Filter images by dominant color or transparency. |
Additional Constraints
nfpr：Default:falsesafe：Default:1；Options: 2 options. Examples:1,2imgar：Options: 4 options. Examples:s,t,w,xwimgsz：Options: 17 options. Examples:l,m,i,qsvga,vgafilter：Default:falselicenses：Options: 6 options. Examples:f,fc,fm,fmc,climage_type：Options: 5 options. Examples:face,photo,clipart,lineart,animatedimage_color：Options: 14 options. Examples:bw,trans,red,orange,yellow
Geographic Location
| Field | Type | Required | Description |
|---|---|---|---|
uule | string | No | Encoded Google location string for more precise geo-targeting. |
location | string | No | Location hint used to make results closer to a target place. |
Additional Constraints
location：Default:US；Options: 10 options. Examples:IN,US,BR,ID,MX
Request Controls
| Field | Type | Required | Description |
|---|---|---|---|
device | string | No | Device type used when requesting results, such as desktop or tablet. |
no_cache | boolean | No | Skip cached results and force a fresh fetch. |
Additional Constraints
device：Default:desktop；Options: 3 options. Examples:desktop,tablet,mobileno_cache：Default:false
Time Period
| Field | Type | Required | Description |
|---|---|---|---|
end_date | string | No | End date for an explicit date range filter. |
start_date | string | No | Start date for an explicit date range filter. |
period_unit | string | No | Time unit used with period_value for recent-image filtering. |
period_value | string | No | Numeric duration used with period_unit. |
Additional Constraints
period_unit：Options: 7 options. Examples:Second,Minute,Hour,Day,Week