Google Shopping API 概览

Google Shopping API 提供 Google Shopping 商品搜索、产品、卖家、广告跳转链接及评论数据，适用于商品 Feed 优化、竞品调研、价格监测和广告投放策略调整。

本接口返回的数据与请求中指定的搜索引擎、语言和地区。本平台会尽可能准确地模拟指定的搜索环境，使返回结果匹任务创建时对应参数下的搜索结果。

返回结果通常 check_url 字段。你可以在无痕浏览器中访问该地址，核验结果与目标搜索环境是否一致。系统不会使用用户偏好、搜索历史等个性化因素，因此这些因素不会影响返回的 SERP 数据。

主接口契约

本概览涉及以下接口路径：

• POST /v3/merchant/google/products/task_post/：提交 Google Shopping 商品搜索任务
• POST /v3/merchant/google/product_info/task_post/：提交商品查询任务
• POST /v3/merchant/google/sellers/task_post/：提交商品卖家查询任务
• GET /v3/merchant/google/sellers/ad_url/：获取 Google Shopping 卖家广告跳转链接
• POST /v3/merchant/google/reviews/task_post/：提交商品评论查询任务

上述任务接口使用标准任务模式。提交任务后，需要通过对应的任务查询接口获取结果，也可以回调地址，在任务完成后接收通知或结果。

可获取的数据

通过 Google Shopping API，可以获取以下数据：

Google Shopping 商品

通过查询指定 Google Shopping 搜索结果中的商品，接口可返回：

• 商品标题
• Google Shopping 搜索结果中的商品描述
• 商品排名
• 商品价格
• 评论数量与评分
• 商品域名

接口路径：

POST /v3/merchant/google/products/task_post/

Google Shopping 商品

获取商品页数据：

• 商品特征
• 商品图片
• 用户评论
• 商品变体
• 商品卖家

接口路径：

POST /v3/merchant/google/product_info/task_post/

Google Shopping 卖家

查询指定商品的卖家列表。每个卖家通常：

• 商品基础价格
• 商品总价 -送信息
• 购买信息
• 特别优惠

接口路径：

POST /v3/merchant/google/sellers/task_post/

Google Shopping 卖家广告 URL

获取卖家广告跳转地址及卖家设置的附加参数。

该接口不需要单独提交 POST 任务，可直接通过 GET 请求，并根据 URL 中的 $shop_ad_aclk 参数获取结果。

接口路径：

GET /v3/merchant/google/sellers/ad_url/

Google Shopping 商品评论

获取指定商品的详细评论数据。

接口路径：

POST /v3/merchant/google/reviews/task_post/

数据获取函数

Google Shopping API 提供两种标准数据函数。

Advanced

advanced 函数返回结构化的 Google Shopping 数据，支持根据以下条件查询：

• keyword：搜索
• product_id：商品 ID
• 语言
• 地区

该函数适合直接获取商品、价格、评分、卖家等结构化字段。

HTML

html 函数返回 Google Shopping 的原始 HTML 页面，支持根据以下条件查询：

• keyword：搜索
• product_id：商品 ID
• 语言
• 地区

该函数适合需要自行解析页面结构或保留原始页面的场景。

任务提交示例

以下示例以商品搜索任务为例。POST 请求体使用 JSON 数组格式，每个数组代表一个任务。

curl --request POST \
  --url https://api.seermartech.cn/v3/merchant/google/products/task_post/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "running shoes",
      "language_code": "en",
      "location_code": 2840,
      "priority": "normal"
    }
  ]'

请求参数的取值请以对应接口的参数说明为准。

数据获取方式

Google Shopping API 支持标准任务获取方式，通常需要分别发送 POST 和 GET 请求：

1. 发送 POST 请求创建任务；
2. 等任务完成；
3. 通过任务查询接口获取结果。

也可以在创建任务时以下回调参数：

• pingback_url：任务完成后接收通知；
• postback_url：任务完成后接收结果。

如果使用 postback_url，还需要指定数据返回函数：

• advanced
• html

如果既未设置 pingback_url，也未设置 postback_url，可以使用 Tasks Ready 接口获取已完成但尚未提取的任务 ID 列表，然后通过 Task GET 接口获取结果。

请求限制

本平台支持的调用频率限制如下：

平台限流以认证说明中的 30/60/120 次/分钟规则为准；

• 每次 POST 请求最多 100 个任务。

如需提高调用上限，请联系平台支持团队。

优级与计费

Google Shopping API 的费用取决于任务执行优级。标准任务模式支持两种优级：

1. normal：普通优级；
2. high：高优级。

高优级通常更快的任务处理速度，费用也可能高于普通优级。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

通用认证方式

所有需要鉴权的请求均应在请求头中携带 API Key：

Authorization: Bearer smt_live_YOUR_KEY

接口路径

• 语言列表：/v3/merchant/google/languages/
• 地区列表：/v3/merchant/google/locations/
• 商品搜索：/v3/merchant/google/products/task_post/
• 商品：/v3/merchant/google/product_info/task_post/
• 卖家列表：/v3/merchant/google/sellers/task_post/
• 卖家广告 URL：/v3/merchant/google/sellers/ad_url/
• 商品评论：/v3/merchant/google/reviews/task_post/

实用场景

• 监测目标下的商品排名与价格，识别竞品商品的位置和价格变化，支持商品定价与 SEO 优化。
• 采集竞品商品、变体和卖家信息，分析竞品的产品组合、销售渠道和市场覆盖。
• 追踪不同地区和语言环境下的 Shopping 结果，评估本地化商品 Feed 和广告投放策略的展示效果。
• 分析商品评分与用户评论，提炼竞品产品质量、用户痛点和功能需求，为产品迭代提供依据。
• 获取卖家广告跳转链接及附加参数，还原广告落地路径，广告竞品监测和投放归因分析。