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/successプロバイダー原価
Success rate: 58.3%Last 30 days · 124 calls
Latency p50: 5.6 sp95 18 s
Last verified: 2026/09/29Verified working

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

Preview

Try online近日公開Provider docs ↗

Uses platform quota
Synchronous response
Reads public data

パラメータ

パラメータ	型	必須	説明	例
クエリパラメータ
`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 をコンソールで作成したキーに置き換えてください。

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

このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。パラメータはサンプルデータです。呼び出し料金は $0.00015/success です。サービス料を含みます。