Search Google Shopping

litescrape.google.serp.shopping

Returns the Google Shopping product grid, category blocks, sponsored listings and refinement filters

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

GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker预览

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

参数

参数	类型	必填	说明	示例
查询参数
`q`	字符串	可选	Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.	`coffee maker`
`gl`	字符串	可选	Two-letter country code used to localize results.	`us`
`hl`	字符串	可选	Language code such as en, en-GB, or de.	`en`
`num`	整数	可选	Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products.	`60`
`uule`	字符串	可选	Pre-encoded Google location token. Mutually exclusive with location.
`start`	整数	可选	Result offset.
`device`	字符串	可选	Google device layout. Each device is served Google's real layout for it.
`shoprs`	字符串	可选	Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
`on_sale`	布尔	可选	Show only products Google marks as on sale. Cannot be combined with another refinement.
`sort_by`	字符串	可选	Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement.
`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`
`max_price`	数字	可选	Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
`min_price`	数字	可选	Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
`free_shipping`	布尔	可选	Show only products with free shipping. Cannot be combined with another refinement.
`google_domain`	字符串	可选	Google domain used for the request.	`google.com`
`small_business`	布尔	可选	Show only products from small businesses. Cannot be combined with another refinement.

查询参数
q字符串可选
Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.
示例：coffee maker
gl字符串可选
Two-letter country code used to localize results.
示例：us
hl字符串可选
Language code such as en, en-GB, or de.
示例：en
num整数可选
Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products.
示例：60
uule字符串可选
Pre-encoded Google location token. Mutually exclusive with location.
start整数可选
Result offset.
device字符串可选
Google device layout. Each device is served Google's real layout for it.
shoprs字符串可选
Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
on_sale布尔可选
Show only products Google marks as on sale. Cannot be combined with another refinement.
sort_by字符串可选
Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement.
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
max_price数字可选
Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
min_price数字可选
Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
free_shipping布尔可选
Show only products with free shipping. Cannot be combined with another refinement.
google_domain字符串可选
Google domain used for the request.
示例：google.com
small_business布尔可选
Show only products from small businesses. Cannot be combined with another refinement.

代码示例

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

预览

curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker",
    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.serp.shopping?q=coffee+maker", {
  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 计费，已含服务费。