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/successAl precio del proveedor
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 onlinePróximamenteProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parámetros

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Parámetros de consulta
`q`	cadena	Obligatorio	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`	cadena	Opcional	Two-letter country code used to localize results.	`us`
`hl`	cadena	Opcional	Language code such as en, en-GB, or de.	`en`
`prds`	cadena	Opcional	Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
`uule`	cadena	Opcional	Pre-encoded Google location token. Mutually exclusive with location.
`gpcid`	cadena	Opcional	Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.	`16418087637395758399`
`device`	cadena	Opcional	Google device layout. Each device is served Google's real layout for it.
`timeout`	número	Opcional	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`	cadena	Opcional	Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.	`Austin, Texas`
`image_docid`	cadena	Opcional	Optional image document ID from the same shopping result; use with gpcid.	`9437029998757085507`
`google_domain`	cadena	Opcional	Google domain used for the request.	`google.com`
`headline_offer_docid`	cadena	Opcional	Optional headline offer document ID from the same shopping result; use with gpcid.	`8780992468355455962`

Parámetros de consulta
qcadenaObligatorio
Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers.
Ejemplo: coffee maker
glcadenaOpcional
Two-letter country code used to localize results.
Ejemplo: us
hlcadenaOpcional
Language code such as en, en-GB, or de.
Ejemplo: en
prdscadenaOpcional
Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
uulecadenaOpcional
Pre-encoded Google location token. Mutually exclusive with location.
gpcidcadenaOpcional
Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.
Ejemplo: 16418087637395758399
devicecadenaOpcional
Google device layout. Each device is served Google's real layout for it.
timeoutnúmeroOpcional
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.
locationcadenaOpcional
Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
Ejemplo: Austin, Texas
image_docidcadenaOpcional
Optional image document ID from the same shopping result; use with gpcid.
Ejemplo: 9437029998757085507
google_domaincadenaOpcional
Google domain used for the request.
Ejemplo: google.com
headline_offer_docidcadenaOpcional
Optional headline offer document ID from the same shopping result; use with gpcid.
Ejemplo: 8780992468355455962

Ejemplos de código

Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.

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());

La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.00015/success, incluida la tarifa de servicio.