Get a Google Shopping product

litescrape.google.shopping.product

Returns one Google Shopping product's merchant offers, specifications, reviews and related products

Price: $0.00015/successAu prix du fournisseur
Success rate: 58,3 %Last 30 days · 124 calls
Latency p50: 5.6 sp95 18 s
Last verified: 29 sept. 2026Verified working

GEThttps://toolswitch.dev/v1/tools/litescrape.google.shopping.product?q=coffee+maker&gpcid=3753285529675071078&image_docid=5002652757944012799&headline_offer_docid=2823574139643882398

Preview

Try onlineBientôtProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Paramètres

Paramètre	Type	Obligatoire	Description	Exemple
Paramètres de requête
`q`	chaîne	Obligatoire	Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers.	`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`
`prds`	chaîne	Facultatif	Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
`uule`	chaîne	Facultatif	Pre-encoded Google location token. Mutually exclusive with location.
`gpcid`	chaîne	Facultatif	Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.	`16418087637395758399`
`device`	chaîne	Facultatif	Google device layout. Each device is served Google's real layout for it.
`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`
`image_docid`	chaîne	Facultatif	Optional image document ID from the same shopping result; use with gpcid.	`9437029998757085507`
`google_domain`	chaîne	Facultatif	Google domain used for the request.	`google.com`
`headline_offer_docid`	chaîne	Facultatif	Optional headline offer document ID from the same shopping result; use with gpcid.	`8780992468355455962`

Paramètres de requête
qchaîneObligatoire
Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers.
Exemple : coffee maker
glchaîneFacultatif
Two-letter country code used to localize results.
Exemple : us
hlchaîneFacultatif
Language code such as en, en-GB, or de.
Exemple : en
prdschaîneFacultatif
Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
uulechaîneFacultatif
Pre-encoded Google location token. Mutually exclusive with location.
gpcidchaîneFacultatif
Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.
Exemple : 16418087637395758399
devicechaîneFacultatif
Google device layout. Each device is served Google's real layout for it.
timeoutnombreFacultatif
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.
locationchaîneFacultatif
Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
Exemple : Austin, Texas
image_docidchaîneFacultatif
Optional image document ID from the same shopping result; use with gpcid.
Exemple : 9437029998757085507
google_domainchaîneFacultatif
Google domain used for the request.
Exemple : google.com
headline_offer_docidchaîneFacultatif
Optional headline offer document ID from the same shopping result; use with gpcid.
Exemple : 8780992468355455962

Exemples de code

Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.shopping.product?q=coffee+maker&gpcid=3753285529675071078&image_docid=5002652757944012799&headline_offer_docid=2823574139643882398' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/litescrape.google.shopping.product?q=coffee+maker&gpcid=3753285529675071078&image_docid=5002652757944012799&headline_offer_docid=2823574139643882398",
    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.shopping.product?q=coffee+maker&gpcid=3753285529675071078&image_docid=5002652757944012799&headline_offer_docid=2823574139643882398", {
  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.