Online Sellers
GET /search?search_type=product&product_type=sellers_online
The Google Product Online Sellers Parameters are applicable when making a request with search_type=product and product_type=sellers_online to retrieve product online sellers 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 online sellers results for the product ID 12094323291759970870 in the location United States , the request would be:
The following parameters are available for all requests made when search_type=product and product_type=sellers_online .
Parameter | Required | Description |
|---|---|---|
search_type | required | Should be set to search_type=product . |
product_type | required | Should be set to product_type=sellers_online . |
product_id | required | The Google Product ID to retrieve. Google Product IDs are returned by Google Shopping search requests. |
sort_by | optional | Sets the sort ordering of the product online sellers returned. Valid values are:
|
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). |
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 search 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 . |
page | optional | Determines the page of results to return, defaults to 1 . |
max_page | optional | Use the max_page parameter to get multiple pages of results in one request. The API will automatically paginate through pages and concatenate the results into one response. See the Pagination docs for more information. |
Next Steps Google Product Online Sellers Results