Images

3min

Google Image Parameters
﻿GET  /search?engine=google&search_type=images
The Google Image Parameters are applicable when making a request with  search_type=images  to retrieve image results for a given search term. The search term is specified in the  q  parameter and the optional  location  parameter can be used to geo-locate the image request (locations can be retrieved via the Locations API).
Google Image Results
﻿
For example, to request image results for the keyword  pizza  in the location  United States , the request would be:
HTTP
Curl
Node.js
Python
PHP
https://api.serpwow.com/live/search?api_key=demo&search_type=images&q=pizza&location=United+States
https://api.serpwow.com/live/search?api_key=demo&search_type=images&q=pizza&location=United+States
﻿
﻿
Google Image Parameters
The following parameters are available for all requests made when  search_type=images .
Parameter
Required
Description
engine
required
Should be set to engine=google .
search_type
required
Should be set to search_type=images .
q
required
The keyword you want to use to perform the Images search.
location
optional
Determines the geographic location in which the query is executed. You can enter any location as free-text, but if you choose one of the SerpWow built-in locations then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location (note that this behaviour can be disabled via the location_auto parameter).
location_auto
optional
If the location field is set to a SerpWow built-in location from the Locations API , and location_auto is set to true (default) then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location. Valid values are true (default) to enable this behaviour or false to disable.
uule
optional
The Google UULE parameter - use to pass through a custom uule parameter to Google. SerpWow automatically generates the uule when you use the location parameter but we allow you to overwrite it directly by specifying a uule directly.
google_domain
optional
The Google domain to use to run the search query. View the full list of supported google_domain values here . Defaults to google.com .
gl
optional
The gl parameter determines the Google country to use for the query. View the full list of supported gl values here . Defaults to us .
hl
optional
The hl parameter determines the Google UI language to return results. View the full list of supported hl values here . Defaults to en .
lr
optional
The lr parameter limits the results to websites containing the specified language. View the full list of supported lr values here .
cr
optional
The cr parameter instructs Google to limit the results to websites in the specified country. View the full list of supported cr values here .
images_page
optional
Determines the page of results to get when search_type=images . For images Google will return 100 results per page (a Google-imposed limit). Use images_page to specify the page of results to retrieve, for example is images_page=2 the API will return images 100-199.
images_color
optional
Allows you to set the color of the images returned when search_type=images . Valid values are any , black_and_white , transparent , red , orange , yellow , green , teal , blue , purple , pink , white , gray , black or brown .
images_size
optional
Allows you to set the size of the images returned when search_type=images . Valid values are large , medium , or icon .
images_type
optional
Allows you to set the size of the images returned when search_type=images . Allows you to set the type of the images returned when search_type=images . Valid values are clipart , line_drawing , or gif .
images_usage
optional
Allows you to specify the usage rights of the images returned when search_type=images . Valid values are non_commercial_reuse_with_modification or non_commercial_reuse .
time_period
optional
Determines the time period of the results shown. It can be set to last_hour , last_day (for the last 24 hours), last_week (for the last 7 days), last_month , last_year or custom . When using custom you must also specifiy one or both of the time_period_min or time_period_max parameters to define the custom time period.
time_period_min
optional
Determines the minimum (i.e. 'from') time to use when time_period is set to custom . Should be in the form MM/DD/YYYY , I.e. for 31st December 2018 time_period_min would be 12/31/2018 .
time_period_max
optional
Determines the maximum (i.e. 'to') time to use when time_period is set to custom . Should be in the form MM/DD/YYYY , I.e. for 31st December 2018 time_period_max would be 12/31/2018 .
safe
optional
Determines whether Safe Search is enabled for the results. Can be set to active to enable Safe Search, or off to disable Safe Search.
tbs
optional
Sets a specific string to be added to the Google tbs parameter in the underlying Google query. The tbs parameter is normally generated automatically by the API, but it can be set explicitly also.
﻿
Next Steps
     Google Image Results﻿

Parameter	Required	Description
engine	required	Should be set to engine=google .
search_type	required	Should be set to search_type=images .
q	required	The keyword you want to use to perform the Images search.
location	optional	Determines the geographic location in which the query is executed. You can enter any location as free-text, but if you choose one of the SerpWow built-in locations then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location (note that this behaviour can be disabled via the location_auto parameter).
location_auto	optional	If the location field is set to a SerpWow built-in location from the Locations API , and location_auto is set to true (default) then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location. Valid values are true (default) to enable this behaviour or false to disable.
uule	optional	The Google UULE parameter - use to pass through a custom uule parameter to Google. SerpWow automatically generates the uule when you use the location parameter but we allow you to overwrite it directly by specifying a uule directly.
google_domain	optional	The Google domain to use to run the search query. View the full list of supported google_domain values here . Defaults to google.com .
gl	optional	The gl parameter determines the Google country to use for the query. View the full list of supported gl values here . Defaults to us .
hl	optional	The hl parameter determines the Google UI language to return results. View the full list of supported hl values here . Defaults to en .
lr	optional	The lr parameter limits the results to websites containing the specified language. View the full list of supported lr values here .
cr	optional	The cr parameter instructs Google to limit the results to websites in the specified country. View the full list of supported cr values here .
images_page	optional	Determines the page of results to get when search_type=images . For images Google will return 100 results per page (a Google-imposed limit). Use images_page to specify the page of results to retrieve, for example is images_page=2 the API will return images 100-199.
images_color	optional	Allows you to set the color of the images returned when search_type=images . Valid values are any , black_and_white , transparent , red , orange , yellow , green , teal , blue , purple , pink , white , gray , black or brown .
images_size	optional	Allows you to set the size of the images returned when search_type=images . Valid values are large , medium , or icon .
images_type	optional	Allows you to set the size of the images returned when search_type=images . Allows you to set the type of the images returned when search_type=images . Valid values are clipart , line_drawing , or gif .
images_usage	optional	Allows you to specify the usage rights of the images returned when search_type=images . Valid values are non_commercial_reuse_with_modification or non_commercial_reuse .
time_period	optional	Determines the time period of the results shown. It can be set to last_hour , last_day (for the last 24 hours), last_week (for the last 7 days), last_month , last_year or custom . When using custom you must also specifiy one or both of the time_period_min or time_period_max parameters to define the custom time period.
time_period_min	optional	Determines the minimum (i.e. 'from') time to use when time_period is set to custom . Should be in the form MM/DD/YYYY , I.e. for 31st December 2018 time_period_min would be 12/31/2018 .
time_period_max	optional	Determines the maximum (i.e. 'to') time to use when time_period is set to custom . Should be in the form MM/DD/YYYY , I.e. for 31st December 2018 time_period_max would be 12/31/2018 .
safe	optional	Determines whether Safe Search is enabled for the results. Can be set to active to enable Safe Search, or off to disable Safe Search.
tbs	optional	Sets a specific string to be added to the Google tbs parameter in the underlying Google query. The tbs parameter is normally generated automatically by the API, but it can be set explicitly also.

News Top Stories

Videos