Core APIs
...
Google
Shopping & Products

Product

4min

Google Product Parameters

GET /search?search_type=product

The Google Product Parameters are applicable when making a request with search_type=product to retrieve product results for a given product ID. The product ID is specified in the product_id parameter and you should also specify a location parameter to geo-locate the request (locations can be retrieved via the Locations API).

Google Product IDs are returned by Google Shopping search requests.

Products & Location Google Product pages are highly location-sensitive so it is important that you specify a location that matches the location that was used to retrieve the product_id in the original Google Shopping search request.

Google Product Results
Google Product Results


For example, to request product results for the product ID 13244508647295616715 in the location United States , the request would be:

HTTP
Curl
Node.js
Python
PHP



Google Product Parameters

The following parameters are available for all requests made when search_type=product and no product_type parameter is supplied:

Parameter

Required

Description

search_type

required

Should be set to search_type=product .

product_id

required

The Google Product ID to retrieve. Google Product IDs are returned by Google Shopping search requests.

product_free_shipping

optional

Determines whether to filter to only products with free shipping. Valid values are true or false .

product_condition_new

optional

Determines whether to filter to only new (non-used) products. Valid values are true or false .

product_condition_used

optional

Determines whether to filter to only used (non-new) products. Valid values are true or false .

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 Scale SERP 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).

Note that Google Product requests are highly location-sensitive. It's important that you set a location parameter for the geographic location in which the product_id was found.

location_auto

optional

If the location field is set to a Scale SERP 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. Scale SERP 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 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 .



Next Steps      Google Product Results

Updated 22 Aug 2024
Did this page help you?