Google Product
SERP API Google Query Parameters
Configure Google product queries using Thordata’s SERP API, including localization parameters, geotargeting, search type,pagination, and "advanced filters" output options.
product_id,Product ID(Required)
The parameter defines the product for which to retrieve results. Typically found in shopping results that support products (e.g., https://www.google.com/shopping/product/{product_id}).
Example Request:
Example using the parameter product_id: 4887235756540435899
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_product" \
-d "product_id=4887235756540435899" \
-d "json=1"Localization
google_domain,Domain(Optional)
Define the search engine domain name for data crawling (default value: google.com).
You can modify this parameter in the system or refer to the Google domain page to obtain the complete list of supported domain names.
Example Request:
Example results for product_id: 4887235756540435899 ,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_product" \
-d "product_id=4887235756540435899" \
-d "google_domain=google.co.ao" \
-d "json=1"gl ,Country(Optional)
Specify the target country/region for search results (default value: us). Use two-letter country codes(e.g., us, ru, uk).
For the complete list of supported country codes, please refer to: Google’s Country List.
Example Request:
Example results forproduct_id: 4887235756540435899,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_product" \
-d "product_id=4887235756540435899" \
-d "gl=ru" \
-d "json=1"hl ,Language(Optional)
Set the interface language for search results (default value: en). Adopt standard language code formats (e.g., en, es, zh-CN).
For the complete list of supported language codes, please refer to: Google Language Codes.
Example Request:
Example results forproduct_id: 4887235756540435899,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_product" \
-d "product_id=4887235756540435899" \
-d "json=1" \
-d "hl=es"Geographical Location
location ,Location(Optional)
Simulate initiating a search from an exact location, which must be used in conjunction with the uule parameter. If not specified, the geographical location of the proxy server may be adopted.
Example Request:
Example results for product_id:4887235756540435899,location:India,uule:w+CAIQICIFSW5kaWE
uule ,Encoded Location(Optional)
Encode the target geographical location using Base64, which must be used in conjunction with the location parameter.
Example Request:
Example results forproduct_id: 4887235756540435899,location:India,uule:w+CAIQICIFSW5kaWE
Search Types
offers ,Offers Results(Optional)
Get parameter for offer results. Replaces previous seller=online results. It can be set to 1 or true.
The offers parameter cannot be used with the offer_id parameter.
Example Request:
Example results for product_id: 4887235756540435899,offers :1
specs ,Fetch Specs Results(Optional)
Parameter for getting spec results. It can be set to 1 or true.
The specs parameter cannot be used with the offer_id parameter.
Example Request:
Example results for product_id: 4887235756540435899,specs:1
reviews ,Fetch Reviews Results(Optional)
Parameter for getting review results. It can be set to 1 or true.
The reviews parameter cannot be used with the offer_id parameter.
Example Request:
Example results for product_id: 4887235756540435899,reviews:1
Pagination
start ,Result offset(Optional)
Set the starting point for search result pagination (e.g., "start=30" means skipping the first 30 results and starting to display from the 31st result).
Example Request:
Example results for product_id: 4887235756540435899,start:30
page ,Start From Page(Optional)
The parameter defines the page number of Google online sellers. There are 10 results per page. This parameter is equivalent to start (offset) = page * 10.
This parameter is only available when offers are enabled.
Example Request:
Example results for product_id: 4887235756540435899,page:20
Advanced Filters
filter ,Results Filtering(Optional)
Parameter defines filters, sorting, and pagination for reviews and offers results.
Offers filters:
freeship:1 Show only products with free shipping
ucond:1 Show only used products
scoring:p Sort by base price
scoring:tp Sort by total price
scoring:cpd Sort by current promotion deals (special offers)
scoring:mrd Sort by sellers rating
Code Example:
Example results for product_id: 4887235756540435899,filter:ucond:1
offer_id,Offer ID(Optional)
The parameter defines the ID used to get multiple offers from online sellers, which can be found in sellers_results.online_sellers.
The offer_id parameter cannot be used with the offers, specifications, and reviews parameters.
Code Example:
Example results for product_id: 4887235756540435899,offer_id:detali
For further assistance, contact us at [email protected].
Last updated