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
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
uule ,Encoded Location(Optional)
Encodes the target location via Base64. Use with location.
Example Request:
Example results for q : pizza,location:India,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
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
start_date,Start Date(Optional)
Sets the number of results per page (default: 20).
Example Request:
Example results for q : pizza,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
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
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
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
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
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
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
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
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
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
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示例
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
For further assistance, contact us at support@thordata.com.
Last updated