Search Google Shopping

litescrape.google.serp.shopping

Returns the Google Shopping product grid, category blocks, sponsored listings and refinement filters

Price: $0.00015/successAt provider cost
Success rate: 9.9%Last 30 days · 216,867 calls
Latency p50: 1.7 sp95 4.5 s
Last verified: Sep 29, 2026Verified working

GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+makerPreview

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description	Example
Query parameters
`q`	string	Optional	Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.	`coffee maker`
`gl`	string	Optional	Two-letter country code used to localize results.	`us`
`hl`	string	Optional	Language code such as en, en-GB, or de.	`en`
`num`	integer	Optional	Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products.	`60`
`uule`	string	Optional	Pre-encoded Google location token. Mutually exclusive with location.
`start`	integer	Optional	Result offset.
`device`	string	Optional	Google device layout. Each device is served Google's real layout for it.
`shoprs`	string	Optional	Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
`on_sale`	boolean	Optional	Show only products Google marks as on sale. Cannot be combined with another refinement.
`sort_by`	string	Optional	Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement.
`timeout`	number	Optional	Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
`location`	string	Optional	Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.	`Austin, Texas`
`max_price`	number	Optional	Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
`min_price`	number	Optional	Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
`free_shipping`	boolean	Optional	Show only products with free shipping. Cannot be combined with another refinement.
`google_domain`	string	Optional	Google domain used for the request.	`google.com`
`small_business`	boolean	Optional	Show only products from small businesses. Cannot be combined with another refinement.

Query parameters
qstringOptional
Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.
Example: coffee maker
glstringOptional
Two-letter country code used to localize results.
Example: us
hlstringOptional
Language code such as en, en-GB, or de.
Example: en
numintegerOptional
Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products.
Example: 60
uulestringOptional
Pre-encoded Google location token. Mutually exclusive with location.
startintegerOptional
Result offset.
devicestringOptional
Google device layout. Each device is served Google's real layout for it.
shoprsstringOptional
Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
on_salebooleanOptional
Show only products Google marks as on sale. Cannot be combined with another refinement.
sort_bystringOptional
Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement.
timeoutnumberOptional
Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
locationstringOptional
Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
Example: Austin, Texas
max_pricenumberOptional
Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
min_pricenumberOptional
Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
free_shippingbooleanOptional
Show only products with free shipping. Cannot be combined with another refinement.
google_domainstringOptional
Google domain used for the request.
Example: google.com
small_businessbooleanOptional
Show only products from small businesses. Cannot be combined with another refinement.

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.00015/success, including the service fee.