Google Images

SERP API Google Query Parameters

Configure GoogleImages queries using Thordata’s SERP API, including localization parameters, geotargeting, Time period,pagination, and "advanced parameter" output options.

q ,Search Query(Required)

Define the search query used for data crawling (default value: q=pizza). Any keywords in any language are supported.

Example Request: Example with q:pizza parameter

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1"

Localization

google_domain,Domain(Optional)

Defines the domain used for scraping. Default: google.com.

Modify this or refer to the Google Domains page for a full list of supported domains.

Example Request:

Example results for q : pizza ,google_domain: google.co.ao

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "google_domain=google.co.ao" \
 -d "json=1"

gl ,Country(Optional)

Specifies the country/region for localized search results (default: us). Uses a two-letter country code (e.g., us, ru, uk).

For supported codes, see Google’s Country List.

Example Request:

Example results for q : pizza,gl: ru

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"

hl ,Language(Optional)

Sets the UI language for search results (default: en). Uses a two-letter language code (e.g., en, es, zh-CN).

Full list: Google Language Codes.

Example Request:

Example results for q : pizza,hl: es

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

cr ,Set Multiple Countries(Optional)

Restricts results to specific countries using | as a separator (e.g., countryFR|countryDE). Combine with gl for consistent UI/content language.

gl and cr can be combined, but the actual effect follows cr as the priority.

Example Request:

Example results for q : pizza,cr: countryFR|countryDE

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "cr=countryAI|countryAQ"

Geotargeting

location ,Location(Optional)

Simulates searches from a precise location. Must be paired with uule. If omitted, the proxy’s location may be used.

Example Request:

Example results for q : pizza,location:India,uule:w+CAIQICIFSW5kaWE

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

uule ,UULE(Optional)

Encodes the target location via Base64. Use with location.

Example Request:

Example results for q : pizza,location:India,uule:w+CAIQICIFSW5kaWE

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

Time period

period_unit ,Time Period Unit(Optional)

Parameter defines the time period unit to search for the recent images, e.g. from past minute, hour, day etc. Options: s - Second n - Minute h - Hour d - Day w - Week m - Month y - Year

Example Request:

Example results for q : pizza,period_unit:h

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "period_unit=h"

period_value ,period_value(Optional)

Parameter defines an optional time period value that can be used with period_unit to describe time periods like 15 seconds, 42 hours, 178 days etc. Default value: 1 Value range: 1..2147483647

Example Request:

Example results for q : pizza,period_value :178 day

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "period_value=178 day"

start_date,Start Date(Optional)

Sets the number of results per page (default: 20).

Example Request:

Example results for q : pizza,start_date:20250801

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start_date=20250801"

end_date ,End Date(Optional)

Parameter defines the end date of time period you want to limit the image search to. Format: YYYYMMDD Example: 20241231

Example Request:

Example results for q : pizza,end_date:20250801

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "end_date=20250801"

Pagination

ijn ,Page Number (images)(Optional)

Parameter defines the page number for Google Images. There are 100 images per page. This parameter is equivalent to start (offset) = ijn * 100.

Example Request:

Example results for q : pizza,ijn:100

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "ijn=100"

Advanced Filters

chips，Image search filter (alternative)(Optional)

Parameter enables to filter image search. It's a string provided by Google as suggested search, like: red apple. Chips are provided under the section: suggested_searches when ijn = 0. Both chips and serpapi_link values are provided for each suggested search.

Example Request:

Example results for q : pizza,chips:size

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "end_date=20250801" \
 -d "chips=size"

tbs ，Advanced Search Parameters(Optional)

(to be searched) parameter defines advanced search parameters that aren't possible in the regular query field.

Example Request:

Example results for q : pizza,tbs:sur:f

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "tbs=sur:f"

imgar，Aspect Ratio Filtering(Optional)

Parameter defines the set aspect ratio of images. Options: s - Square t - Tall w - Wide xw - Panoramic

Example Request:

Example results for q : pizza,imgar:s

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "imgar=s"

imgsz ，Image Size Filtering(Optional)

Parameter defines the size of images. Options: l - Large m - Medium i - Icon qsvga - Larger than 400×300 vga - Larger than 640×480 svga - Larger than 800×600 xga - Larger than 1024×768 2mp - Larger than 2 MP 4mp - Larger than 4 MP 6mp - Larger than 6 MP 8mp - Larger than 8 MP 10mp - Larger than 10 MP 12mp - Larger than 12 MP 15mp - Larger than 15 MP 20mp - Larger than 20 MP 40mp - Larger than 40 MP

Example Request:

Example results for q : pizza,imgsz:qsvga

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "imgsz=qsvga"

image_color ，Image Color Filtering(Optional)

Parameter defines the color of images. Options: bw - Black and white trans - Transparent red - Red orange - Orange yellow - Yellow green - Green teal - Teal blue - Blue purple - Purple pink - Pink white - White gray - Gray black - Black

Example Request:

Example results for q : pizza,image_color:animated

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "image_type=animated"

image_type，Image Type Filtering(Optional)

Parameter defines the type of images. Options: face - Face photo - Photo clipart - Clip art lineart - Line drawing animated - Animated

Example Request:

Example results for q : pizza,image_type:face

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "image_type=face"

licenses ，Usage Rights Filterin(Optional)

Parameter defines the scope of licenses of images. Options: f - Free to use or share fc - Free to use or share, even commercially fm - Free to use, share or modify fmc - Free to use, share or modify, even commercially cl - Creative Commons licenses ol - Commercial and other licenses

Example Request:

Example results for q : pizza,licenses:f

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "licenses=f"

safe ，Safe(Optional)

Parameter defines the level of filtering for adult content. It can be set to active or off, by default Google will blur explicit content.

Example Request:

Example results for q : pizzasafe:active

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "safe=active"

nfpr ，Exclude Auto-corrected Results(Optional)

Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to 1 to exclude these results, or 0 to include them (default). Note that this parameter may not prevent Google from returning results for an auto-corrected query if no other results are available.

Example Request:

Example results for q : pizza,nfpr:1示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "nfpr=1"

filter ，Results Filtering(Optional)

Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to 1 (default) to enable these filters, or 0 to disable these filters.

Example Request:

Example results for q : pizzafilter:1

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "filter=1"

For further assistance, contact us at [email protected].