我们自己的访问统计默认开启。Google Analytics 只在你同意后启用,用来了解公开页面是否有用,不统计登录后的工作台。详见 隐私政策。

Google 购物

Google 购物 API

按关键词搜 Google 购物商品(一次最多 100 个):标题、价格和划线价、商家、评分、打分人数、图片和商品 ID,可按国家、语言、价格区间和排序筛选,用来做跨商家比价和价格监测。 调用 POST /api/v1/social ;返回结构化 JSON,$0.56 / 千次;失败不计费。

平台运行状态

24h 健康值
正常
正常

30 天趋势

Google 购物 能力清单

能力做什么单价24 小时运行状态
关键词搜索search用 search 搜 Google 购物商品,一次最多 100 个,带价格、商家和评分。$0.56 / 千次正常

点能力名进它的文档:参数、返回字段、代码示例和试用。

Google 购物 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

能力必填参数可选参数单次条数模式单价返回字段
searchkeywordcountry, language, max_price, min_price, sort默认 20 · 最多 100同步$0.56 / 千次rank · title · product_id · offer_id · image_id · price_text · price · old_price_text · old_price · merchant · multiple_merchants · rating · rating_scale · review_count · image_url · url · platform
Google 购物 search 调用流程一次 Google 购物 search 调用的全过程:向 POST /api/v1/social 发送 platform="google_shopping"、action="search",以及必填参数 keyword;返回结构化 JSON,含 rank、title、product_id、offer_id、image_id 等字段;返回列表,单次最多 100 条,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "google_shopping"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表ranktitleproduct_idoffer_idimage_id
一次 Google 购物 search 调用的全过程:向 POST /api/v1/social 发送 platform="google_shopping"、action="search",以及必填参数 keyword;返回结构化 JSON,含 rank、title、product_id、offer_id、image_id 等字段;返回列表,单次最多 100 条,计费 $0.56 / 千次,失败与空结果不计费。

Google 购物 原始字段名

EveryInfra 统一字段名

左边是 Google 购物 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Google 购物 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 6 个字段名只在 Google 购物 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • offer_id
  • image_id
  • old_price_text
  • old_price
  • merchant
  • multiple_merchants

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

rank
该商品在这次搜索结果里的名次,从 1 开始。
title
标题。平台无标题概念时(如纯文本帖)为 null。
product_id
Google 购物的商品聚合 ID(纯数字),同一款商品各商家的报价归在它下面;个别结果没有。
offer_id
这一行展示的那个商家报价的 ID(纯数字)。
image_id
这一行主图的 ID(纯数字)。
price_text
价格原文,带货币符号和当地写法(如 $29.99、Rp 419.000)。
price
price_text 解析出的数值,货币按搜索的国家(country);不带货币单位。
old_price_text
划线原价原文;没有打折就不出现。
old_price
old_price_text 解析出的数值。
merchant
这一行报价的商家名。
multiple_merchants
是否有多个商家卖这款商品(true 时 Google 购物页上能比价)。
rating
商品评分,1–5。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
商品评价数。
image_url
图片链接。多图能力可能返回 image_urls 数组。
url
该记录在原平台上的可访问链接。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

请求填写示例

价格按 country 那个国家的货币;不填 country 时按美国站。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

google_shopping_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"google_shopping","action":"search","params":{"keyword":"wireless earbuds"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "rank": null,
  "title": null,
  "product_id": null,
  "offer_id": null,
  "image_id": null,
  "price_text": null,
  "price": null,
  "old_price_text": null,
  "old_price": null,
  "merchant": null,
  "multiple_merchants": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "image_url": null,
  "url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

Google 购物 API 如何按关键词比价?

用 search 搜 Google 购物商品,一次最多 100 个,带价格、商家和评分。

查看 search 的 keyword 参数
  • keyword 填商品词;country 选国家站(默认 us),价格按那个国家的货币;可用 min_price、max_price 限价格区间,sort 按 price_low、price_high、rating 排序。
  • 每行有 title、price(数值)和 price_text(原文)、划线原价 old_price、商家 merchant、rating、review_count、图片和 Google 商品 ID product_id。

Google 购物 API 常见问题

Google 购物 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="google_shopping"、action 和 params。以 search 为例,必填 keyword,可选 country、language、max_price、min_price。价格按 country 那个国家的货币;不填 country 时按美国站。 Google 购物 共 1 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Google 购物 API 怎么收费?

$0.56 / 千次,Google 购物 全部 1 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 1,798 次 Google 购物 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Google 购物 API 一次能返回多少条数据?

Google 购物 有 1 个列表接口,包括 search。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Google 购物 API 返回哪些字段?

当前目录为 search 列出 rank、title、product_id、offer_id、image_id、price_text 等 17 个字段名。按全站当前目录统计,6 个字段名只在 Google 购物 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

Google 购物 API 如何按关键词比价?

用 search 搜 Google 购物商品,一次最多 100 个,带价格、商家和评分。 keyword 填商品词;country 选国家站(默认 us),价格按那个国家的货币;可用 min_price、max_price 限价格区间,sort 按 price_low、price_high、rating 排序。 每行有 title、price(数值)和 price_text(原文)、划线原价 old_price、商家 merchant、rating、review_count、图片和 Google 商品 ID product_id。

可以先免费试用 Google 购物 API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 Google 购物 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 1 个能力。无需信用卡。

开始调用 Google 购物 API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 Google 购物 接口验证结果。

免费开始