Google Shopping API

Google Shopping 搜索 API

按关键词搜索 Google Shopping,获取最多 10 条商品报价(标题、价格、商店、评分和链接),按国家和语言本地化。

US$16.00/千次请求,按请求付费,无需订阅。

airpods - Google Shopping
google.com/search?q=airpods&tbm=shop
Google
airpods
AllShoppingImagesVideosNewsWeb

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)

API 返回的内容items[0]
{
"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 个字段
}
可用率
99.27%
30d · 1,929 次调用
请求数
1,930
30d · 按周,近 12 周
响应时间
5.8s
中位数 · 30d

调用方式

一个请求获取 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 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

each itemdata.items[]

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.

top level
  • 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 次调用。

费用:每千次请求 US$16 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

按关键词搜索 Google Shopping,获取最多 10 条商品报价(标题、价格、商店、评分和链接),按国家和语言本地化。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 Google Shopping 搜索 API 调用中有 99.3% 成功,响应时间中位数为 5.8 秒,共测量 1,929 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 6 次 Google Shopping 搜索,每次 US$0.016。

AnyAPI 会在同一个请求中依次尝试它的 3 个数据源,从最便宜的开始,所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/google_shopping.search 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。