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/successAt provider cost
Success rate: 58.3%Last 30 days · 124 calls
Latency p50: 5.6 sp95 18 s
Last verified: Sep 29, 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 onlineComing soonProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description	Example
Query parameters
`q`	string	Required	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`	string	Optional	Two-letter country code used to localize results.	`us`
`hl`	string	Optional	Language code such as en, en-GB, or de.	`en`
`prds`	string	Optional	Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
`uule`	string	Optional	Pre-encoded Google location token. Mutually exclusive with location.
`gpcid`	string	Optional	Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.	`16418087637395758399`
`device`	string	Optional	Google device layout. Each device is served Google's real layout for it.
`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`
`image_docid`	string	Optional	Optional image document ID from the same shopping result; use with gpcid.	`9437029998757085507`
`google_domain`	string	Optional	Google domain used for the request.	`google.com`
`headline_offer_docid`	string	Optional	Optional headline offer document ID from the same shopping result; use with gpcid.	`8780992468355455962`

Query parameters
qstringRequired
Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers.
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
prdsstringOptional
Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
uulestringOptional
Pre-encoded Google location token. Mutually exclusive with location.
gpcidstringOptional
Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.
Example: 16418087637395758399
devicestringOptional
Google device layout. Each device is served Google's real layout for it.
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
image_docidstringOptional
Optional image document ID from the same shopping result; use with gpcid.
Example: 9437029998757085507
google_domainstringOptional
Google domain used for the request.
Example: google.com
headline_offer_docidstringOptional
Optional headline offer document ID from the same shopping result; use with gpcid.
Example: 8780992468355455962

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the 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());

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.