Google Shopping SERP API Parameters Guide
Review Google Shopping SERP API parameters for product searches, locations, languages, filters, and shopping result data.
With Talordata SERP API, you can configure Google Shopping queries, including localization, geographic targeting, 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://serpapi.talordata.net/serp/v1/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-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://serpapi.talordata.net/serp/v1/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-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://serpapi.talordata.net/serp/v1/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-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://serpapi.talordata.net/serp/v1/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"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
Pagination
start ,Result offset(Optional)
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).
Example Request:
Example results for q : pizza,start:30
num ,Results per page(Optional)
Sets the number of results per page (default: 20).
Example Request:
Example results for q : pizza,num:20
Advanced Parameters
tbs ，Advanced Search Parameters(Optional)
Time/type filtering (supports complex conditions), such as tbs=qdr:d qdr:d= contents within 24 hours tbs=sur:f, for example, shows only images
Example Request:
Example results for q : pizza,tbs:sur:f
shoprs ，Search Filter ID(Optional)
The parameter defines the token that includes metadata about query and search filter(s). Providing qparameter alongside the shoprs is not required.
Example Request:
Example results for q : pizza,shoprs:shoprs_1
min_price ，Lowest Price (Optional)
The lower limit for the price range query. This parameter will override the corresponding filter embedded in the 'shoprs' parameter.
Example Request:
Example results for q : pizza,min_price:10
max_price ，Highest Price (Optional)
The upper limit for the price range query. This parameter overrides the corresponding filter embedded within the shoprs parameter.
Example Request:
Example results for q : pizza,max_price:100
sort_by，Sort by(Optional)
The parameter defines the sorting order of the results.
Available Options:
1 - Price: Low to High
2 - Price: High to Low
Example Request:
Example results for q : pizza,sort_by:1
free_shipping，free shipping(Optional)
Show only items with free shipping.
Example Request:
Example results for q : pizza,free_shipping:true
on_sale，On Sale (Optional)
Show only items currently on sale.
Example Request:
Example results for q : pizza,on_sale:true
small_business，Small Businesses (Optional)
Show only products from small businesses.
Example Request:
Example results for q : pizza,small_business:true
direct_link，Includes direct links (Optional)
This parameter determines whether search results should include a direct link to each product. By default, it is set to false; if you require direct links, please set it to true.
Example Request:
Example results for q : pizza,direct_link:true
If you need further assistance, feel free to contact us via live chat or email [email protected].
Last updated