Product
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.
For example, to request product results for the product ID 13244508647295616715 in the location United States , the request would be:
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