Google Shopping 搜索 API
按关键词搜索 Google Shopping,获取最多 10 条商品报价(标题、价格、商店、评分和链接),按国家和语言本地化。
US$16.00/千次请求,按请求付费,无需订阅。
Apple AirPods Pro 2 with USB-C
$219.99$249.00
12% OFF
Best Buy
★ 4.8 (15,234)
Apple AirPods 4
$129.00
Target
★ 4.7 (8,921)
Apple AirPods Max
$449.00$549.00
18% OFF
Walmart
★ 4.6 (3,021)
{"title": "Apple AirPods Pro 2 with USB-C","url": "https://www.google.com/shopping/product/11029384756?q=airpods","image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:airpods-pro-2-usb-c","productId": "11029384756","seller": "Best Buy","brand": "Apple","price": 219.99,"priceText": "$219.99",... 还有 6 个字段}
价格与服务商
Google Shopping 搜索 API 价格:一个 API,3 个可互换的服务商
最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。
每次请求封顶 US$0.06381 条结果US$0.01435 条结果US$0.036310 条结果US$0.0638(封顶)按实际返回的内容计费。调低返回数量上限即可少付,而且无论返回多少,单次请求都不会超过封顶价。
调用方式
一个请求获取 Google Shopping 搜索
import os, requests res = requests.post( "https://api.getanyapi.com/v1/run/google_shopping.search", headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"}, json={ "query": "airpods", "country": "us", "language": "en", "limit": 10 }, ) print(res.json())
这个示例展示了 18 个字段中的 17 个。查看全部字段
{
"found": true,
"data": {
"items": [
{
"title": "Apple AirPods Pro 2 with USB-C",
"url": "https://www.google.com/shopping/product/11029384756?q=airpods",
"image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:airpods-pro-2-usb-c",
"productId": "11029384756",
"seller": "Best Buy",
"brand": "Apple",
"price": 219.99,
"priceText": "$219.99",
"currency": "USD",
"listPrice": 249,
"listPriceText": "$249.00",
"discountPercent": "12% OFF",
"rating": 4.8,
"reviewsCount": 15234
},
{
"title": "Apple AirPods 4",
"url": "https://www.google.com/shopping/product/11029384812?q=airpods",
"image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:airpods-4",
"productId": "11029384812",
"seller": "Target",
"brand": "Apple",
"price": 129,
"priceText": "$129.00",
"currency": "USD",
"listPrice": 0,
"listPriceText": "",
"discountPercent": "",
"rating": 4.7,
"reviewsCount": 8921
},
{
"title": "Apple AirPods Max",
"url": "https://www.google.com/shopping/product/11029384930?q=airpods",
"image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:airpods-max",
"productId": "11029384930",
"seller": "Walmart",
"brand": "Apple",
"price": 449,
"priceText": "$449.00",
"currency": "USD",
"listPrice": 549,
"listPriceText": "$549.00",
"discountPercent": "18% OFF",
"rating": 4.6,
"reviewsCount": 3021
}
]
}
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
一个请求,一种响应结构。
你发送的每个字段和收到的每个字段,都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- querystring
airpods
要搜索的商品名称、品牌或关键词(例如 "Nike running shoes")。
- conditionenum
NEW
只返回此成色的商品(例如 "USED");默认不限成色。
- countrystring
us
用于本地化结果的 ISO 3166-1 alpha-2 国家代码(例如 "us"、"gb"、"de")。
- languagestring
en
结果使用的 ISO 639-1 语言代码(例如 "en"、"es"、"fr")。
- limitinteger
3
最多返回的结果数(1-10,默认 10)。
- requireFieldsarray
可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `listPriceText` 或 `discountPercent`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
- sortByenum
BEST_MATCH
结果排序方式(例如 "LOWEST_PRICE");默认按相关性。
响应
JSON,每个字段一个示例值。
Matching Google Shopping product offers. Populated whenever the provider has data for the entity.
- brandstring可设为必填
Apple
Product brand; empty when not reported.
- currencystring可设为必填
USD
Price currency code, e.g. "USD"; empty when not reported.
- discountPercentstring可设为必填
12% OFF
Discount label when on sale, e.g. "23% OFF"; empty otherwise.
- imagestring
https://encrypted-tbn0.gstatic.com/shopping?q=tbn:airpods-pro-2-usb-c
Primary product image URL. Populated whenever the provider has data for the entity.
- listPricenumber
249
Pre-discount list price as a numeric amount; 0 when not on sale or reported only as text.
- listPriceTextstring可设为必填
$249.00
Pre-discount list price as displayed, e.g. "$130"; empty when not applicable.
- pricenumber
219.99
Current price as a numeric amount; 0 when the lane reports price only as text (see priceText).
- priceTextstring可设为必填
$219.99
Current price as displayed, e.g. "$99.99"; empty when the lane reports a numeric price instead.
- productIdstring
11029384756
Provider product identifier.
- ratingnumber
4.8
Average product rating, 0-5; null when unrated.
- reviewsCountinteger
15234
Number of ratings / reviews; null when none reported.
- sellerstring
Best Buy
Store / seller name offering the product, e.g. "Target".
- titlestring
Apple AirPods Pro 2 with USB-C
Product title. Populated whenever the provider has data for the entity.
- urlstring
https://www.google.com/shopping/product/11029384756?q=airpods
Google Shopping product page URL (query retained; it encodes the product identity). Populated whenever the provider has data for the entity.
- foundboolean
true
True when the search returned at least one product offer.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 Google Shopping 搜索 API
AnyAPI 的 Google Shopping 搜索 API 只需一次 POST 请求 /v1/run/google_shopping.search,就以统一格式的 JSON 返回 Google Shopping 数据。按关键词搜索 Google Shopping,获取最多 10 条商品报价(标题、价格、商店、评分和链接),按国家和语言本地化。AnyAPI 会在 3 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$16 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Google Shopping 搜索 API 调用中有 99.3% 成功,响应时间中位数为 5.8 秒,共测量 1,929 次调用。