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

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 "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

uule ,UULE(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

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 "location=India" \
 -d "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

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 "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

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 "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

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 "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

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 "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

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 "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

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 "filter=ucond:1" \
 -d "json=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

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 "offer_id=detali"

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