Get a Google Shopping product

litescrape.google.shopping.product

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

价格: $0.00015/success按供应商原价
成功率: 58.3%近 30 天 · 124 次
延迟 p50: 5.6 秒p95 18 秒
最后验证: 2026年9月29日实测可用

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

预览

在线试用即将上线供应商文档 ↗

可用平台额度调用
同步返回
读取公开数据

参数

参数	类型	必填	说明	示例
查询参数
`q`	字符串	必填	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`	字符串	可选	Two-letter country code used to localize results.	`us`
`hl`	字符串	可选	Language code such as en, en-GB, or de.	`en`
`prds`	字符串	可选	Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
`uule`	字符串	可选	Pre-encoded Google location token. Mutually exclusive with location.
`gpcid`	字符串	可选	Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.	`16418087637395758399`
`device`	字符串	可选	Google device layout. Each device is served Google's real layout for it.
`timeout`	数字	可选	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`	字符串	可选	Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.	`Austin, Texas`
`image_docid`	字符串	可选	Optional image document ID from the same shopping result; use with gpcid.	`9437029998757085507`
`google_domain`	字符串	可选	Google domain used for the request.	`google.com`
`headline_offer_docid`	字符串	可选	Optional headline offer document ID from the same shopping result; use with gpcid.	`8780992468355455962`

查询参数
q字符串必填
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字符串可选
Two-letter country code used to localize results.
示例：us
hl字符串可选
Language code such as en, en-GB, or de.
示例：en
prds字符串可选
Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.
uule字符串可选
Pre-encoded Google location token. Mutually exclusive with location.
gpcid字符串可选
Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.
示例：16418087637395758399
device字符串可选
Google device layout. Each device is served Google's real layout for it.
timeout数字可选
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字符串可选
Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
示例：Austin, Texas
image_docid字符串可选
Optional image document ID from the same shopping result; use with gpcid.
示例：9437029998757085507
google_domain字符串可选
Google domain used for the request.
示例：google.com
headline_offer_docid字符串可选
Optional headline offer document ID from the same shopping result; use with gpcid.
示例：8780992468355455962

代码示例

将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。

预览

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

网关接口为预览版，地址与鉴权方式可能调整。示例参数仅为样例数据。调用按 $0.00015/success 计费，已含服务费。