Product Details *New*
Google Product Details Parameters
GET /search?search_type=product_details
The Google Product Details Parameters are applicable when making a request with search_type=product_details to retrieve product results from the Product knowledge pannel for a given product ID and gpc ID. The product ID is specified in the product_id parameter and gpc id is specificied in gpc_id .You should also specify a location parameter to geo-locate the request (locations can be retrieved via the Locations API).
Product details requests return a variant_hash which is a unique identifier used to get a variant-specific information for a product. You can use variant_hash in combination with product_id and gpc_id and request product_details again to fetch variant-specific product details if available.
Google Product IDs and gpc 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. To ensure appropriate product details are returned, either location or gl and hl are required for search_type=product_details.
For example, to request product results for the product ID 2826726591980094389 and gpc id 2883234210698146338 in the location United States , the request would be:
https://api.scaleserp.com/search?api_key=demo&search_type=product_details&product_id=2826726591980094389&gpc_id=2883234210698146338&location=United+StatesGoogle Product Parameters
The following parameters are available for all requests made when search_type=product_details is supplied:
Parameter | Required | Description |
|---|---|---|
engine | required | Should be set to engine=google . |
search_type | required | Should be set to search_type=product_details . |
product_id | required | The Google Product ID to retrieve. Google Product IDs are returned by Google Shopping search requests. |
gpc_id | required | The Google Product GPC ID to retrieve. Google Product GPC IDs are returned by Google Shopping search requests. Note: For some products like medicines, Google Shopping page does not return a GPC ID. In those cases, product_details & sellers_online requests work by supplying the product_id value to BOTH product_id and gpc_id. Also, in such cases, BOTH location + gl, hl & domain are required (as opposed to either of those required in products containing a gpc_id) |
variant_hash | optional | The unique ID used to select and retrieve a product's variant information if available. Returned from Google Product Details request, found in product_results.variants.values.variant_hash when available. Use variant_hash in combination with product_id and gpc_id to request product_details or sellers_online for selected variants if available. |
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: 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. Either location or gl and hl are required to get correct product details. |
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 . Note: Either location or gl and hl are required to get correct product details. |
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 . Note: Either location or gl and hl are required to get correct product details. |
Next Steps Google Product Results