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
﻿
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
https://api.valueserp.com/search?api_key=demo&search_type=product&product_id=13244508647295616715&location=United+States
https://api.valueserp.com/search?api_key=demo&search_type=product&product_id=13244508647295616715&location=United+States
﻿
﻿
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 VALUE 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 VALUE 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. VALUE 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﻿

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 VALUE 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 VALUE 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. VALUE 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 .

Updated 10 Oct 2024

Did this page help you?

Reviews