Search Google Shopping
litescrape.google.serp.shoppingReturns the Google Shopping product grid, category blocks, sponsored listings and refinement filters
- Price
- $0.00015/successAu prix du fournisseur
- Success rate
- 9,9 %Last 30 days · 216 867 calls
- Latency p50
- 1.7 sp95 4.5 s
- Last verified
- 29 sept. 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+makerPreview- Uses platform quota
- Synchronous response
- Reads public data
Paramètres
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Paramètres de requête | ||||
q | chaîne | Facultatif | 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 | chaîne | Facultatif | Two-letter country code used to localize results. | us |
hl | chaîne | Facultatif | Language code such as en, en-GB, or de. | en |
num | entier | Facultatif | 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 | chaîne | Facultatif | Pre-encoded Google location token. Mutually exclusive with location. | |
start | entier | Facultatif | Result offset. | |
device | chaîne | Facultatif | Google device layout. Each device is served Google's real layout for it. | |
shoprs | chaîne | Facultatif | Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries. | |
on_sale | booléen | Facultatif | Show only products Google marks as on sale. Cannot be combined with another refinement. | |
sort_by | chaîne | Facultatif | 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 | nombre | Facultatif | 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 | chaîne | Facultatif | Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule. | Austin, Texas |
max_price | nombre | Facultatif | 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 | nombre | Facultatif | Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business. | |
free_shipping | booléen | Facultatif | Show only products with free shipping. Cannot be combined with another refinement. | |
google_domain | chaîne | Facultatif | Google domain used for the request. | google.com |
small_business | booléen | Facultatif | Show only products from small businesses. Cannot be combined with another refinement. | |
- Paramètres de requête
qchaîneFacultatifProduct search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.
Exemple :
coffee makerglchaîneFacultatifTwo-letter country code used to localize results.
Exemple :
ushlchaîneFacultatifLanguage code such as en, en-GB, or de.
Exemple :
ennumentierFacultatifNumber 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.
Exemple :
60uulechaîneFacultatifPre-encoded Google location token. Mutually exclusive with location.
startentierFacultatifResult offset.
devicechaîneFacultatifGoogle device layout. Each device is served Google's real layout for it.
shoprschaîneFacultatifRefinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
on_salebooléenFacultatifShow only products Google marks as on sale. Cannot be combined with another refinement.
sort_bychaîneFacultatifSort 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.
timeoutnombreFacultatifOptional 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.
locationchaîneFacultatifHuman-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
Exemple :
Austin, Texasmax_pricenombreFacultatifUpper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
min_pricenombreFacultatifLower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
free_shippingbooléenFacultatifShow only products with free shipping. Cannot be combined with another refinement.
google_domainchaîneFacultatifGoogle domain used for the request.
Exemple :
google.comsmall_businessbooléenFacultatifShow only products from small businesses. Cannot be combined with another refinement.
Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.
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());Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.00015/success, frais de service inclus.