Amazon关键词搜索 API

Q: 怎么搜英国、日本等其他站点？

用 domain 传站点域名，例如 amazon.co.uk、amazon.co.jp，不带 https:// 和路径；不传时默认 amazon.com。lang 只改变页面语言，不会切换站点。

Q: lang 该怎么填？

只接受接口列出的语言代码，例如 en、ja、de；简体中文填 zhcn，繁体中文填 zhtw，不能写成笼统的 zh。语言只影响页面文字，不影响商品所在的站点。

Q: 搜到商品后怎么看评价？

用结果的 asin 拼出 https://www.amazon.com/dp/ 这样的商品链接（换成搜索时的站点），传给 Amazon 的评价能力；非美国站还要在评价能力的 domain 里传同一个站点，否则按 amazon.com 读。

POST

接口健康状态

24h 健康值: 正常
24h 平均耗时: —

健康 / 正常
可用
少量可用
基本不可用

正常

24 小时趋势

30 天趋势

关键词搜索：返回列表，默认 10 条、单次最多 50 条；主要字段 asin、title、url、brand、price、list_price。

Amazon 关键词搜索按 keyword 检索 Amazon 商品，返回 ASIN、标题、品牌、价格与划线原价、评分和评分人数、是否有货、分类、图片、卖家，以及是否带 Amazon's Choice 标。它回答「这个关键词下有哪些商品、价位和口碑如何」，适合跨境选品、竞品价格扫描和观察关键词下的市场格局。

用 domain 指定国家站点，例如 amazon.co.uk；用 lang 指定页面语言，简体和繁体中文分别是 zhcn 和 zhtw，选择语言不等于切换站点。结果里的 asin 可以拼出商品链接，交给 Amazon 的商品详情或评价能力继续深挖；rating_count 少的商品，评分的参考价值有限。

单价 $1.39 / 千次（每次 $0.001389），失败与空结果不扣费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

AI 提示词

复制下面这段给你常用的 AI 助手：里面写好了这个接口的参数、返回字段和示例请求，它会先问清你的需求，再帮你写采集脚本。

请帮我用 EveryInfra 的「Amazon 关键词搜索」接口（amazon/search）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 amazon，action 填 search，参数放在 params 里。
- 必填参数：
  - keyword：随接口区分：search 是商品搜索词；bestsellers 优先传 Amazon 类目畅销榜完整 URL，也接受用于拼接榜单路径的类目短名。
- 可选参数：
  - domain：Amazon 国家站点域名，例如 amazon.com、amazon.co.uk、amazon.co.jp；不要带 https:// 或页面路径。
  - lang：页面内容语言。en / ja 等为英文 / 日文；简体和繁体中文使用 zhcn / zhtw，不是通用 zh。只接受当前接口列出的语言代码，选择语言不等于切换国家站点。（可选值：ar / bn / cs / da / de / en / es / fr）
  - limit：这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 10）
- 返回一组记录，每条记录的主要字段：asin（Amazon 标准识别号）、title、url、brand（品牌）、price、list_price（划线原价）、currency、rating、rating_scale、rating_count、in_stock（是否有货）、category；一共 19 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=amazon。
- 示例请求体：
{
  "platform": "amazon",
  "action": "search",
  "params": {
    "keyword": "coffee grinder"
  }
}
- 计费：$1.39 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`platform`	body	`string`	是	`amazon`	平台标识，固定值。
`action`	body	`string`	是	`search`	能力标识，固定值。
`keyword`	body.params	未声明	是	-	随接口区分：search 是商品搜索词；bestsellers 优先传 Amazon 类目畅销榜完整 URL，也接受用于拼接榜单路径的类目短名；sellers 可传商品/卖家相关页面 URL，普通文字则先构造商品搜索页，并非按卖家 ID 精确查找。
`domain`	body.params	未声明	否	-	Amazon 国家站点域名，例如 amazon.com、amazon.co.uk、amazon.co.jp；不要带 https:// 或页面路径。search 用它构造搜索页，reviews 用它选择评论站点，默认 amazon.com；非美国商品评论应显式选择与商品链接一致的站点。
`lang`	body.params	`enum`	否	-	页面内容语言。en / ja 等为英文 / 日文；简体和繁体中文使用 zhcn / zhtw，不是通用 zh。只接受当前接口列出的语言代码，选择语言不等于切换国家站点。允许值`arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw`
`limit`	body.params	`integer (1–50)`	否	`10`	这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。

代码示例

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "amazon",
  "action": "search",
  "params": {
    "keyword": "coffee grinder"
  }
}'

[OpenAPI 定义 (JSON)]示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

这里传商品检索词；指定商品评价请使用 reviews 和商品链接。

响应示例

真实返回样例

2026年9月26日 16:56（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息，列表只保留前 2 条；id、billing、quota 每次调用都不同，只给结构。

json

{
  "id": "req_…",
  "platform": "amazon",
  "action": "search",
  "results": [
    {
      "asin": "B0GWHGT8C6",
      "title": "SHARDOR Burr Coffee Grinder Electric with 32 Grinding Sizes, 2026 Upgraded",
      "url": "https://www.amazon.com/dp/B0GWHGT8C6",
      "brand": "SHARDOR",
      "price": 39.98,
      "list_price": 49.99,
      "currency": "$",
      "rating": 4.4,
      "rating_count": 23,
      "in_stock": true,
      "category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
      "image_url": "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SY300_SX300_QL70_FMwebp_.jpg",
      "is_amazon_choice": false,
      "seller_name": "KDSXG",
      "platform": "amazon",
      "images": [
        "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71WkUEs07pL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71h+360x8gL._AC_SL1500_.jpg"
      ],
      "features": [
        "CONSISTENT DAILY GRINDING Designed for home coffee routines, this flat burr grinder helps prepare beans for drip, pour over, french press, cold brew, moka pot, and espresso style drinks. The compact body fits small counters, apartments, office corners, and coffee stations without…",
        "SMALL BATCH CONTROL The adjustable time based grinding design lets users grind only what they need for fresh cups, single serve brewers, or family coffee prep. To help protect the motor, the built in safety program supports up to 120 seconds of continuous operation before a short…",
        "32 SIZE OPTIONS Choose from 32 grind settings to match different brewing needs, from finer grounds for espresso style preparation to coarser grounds for french press and cold brew. The grinder includes a chamber, cleaning brush, and hopper for daily use and simple upkeep."
      ],
      "bestseller_ranks": [
        {
          "rank": 19549,
          "category": "Home & Kitchen"
        },
        {
          "rank": 7,
          "category": "Burr Coffee Grinders"
        }
      ],
      "rating_scale": 5
    },
    {
      "asin": "B0HB98V4SP",
      "title": "Flat Burr Coffee Grinder Electric, Adjustable Coffee Bean Grinder with 17 Grinding Sizes, Burr Mill for Espresso & French Press, 2-12 Cup, Silver",
      "url": "https://www.amazon.com/dp/B0HB98V4SP",
      "brand": "Rounexes",
      "price": 39.99,
      "currency": "$",
      "rating": 5,
      "rating_count": 17,
      "in_stock": true,
      "category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
      "image_url": "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SY300_SX300_QL70_FMwebp_.jpg",
      "is_amazon_choice": false,
      "seller_name": "MeiDing",
      "platform": "amazon",
      "images": [
        "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/81khWIt-ThL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/712ulwCFZuL._AC_SL1500_.jpg"
      ],
      "features": [
        "[17 Precise Grind Settings] From fine espresso to coarse French press, dial in the perfect grind across 17 calibrated levels—ideal for drip, pour-over, or cold brew, and designed to unlock your beans’ full aroma every morning.",
        "[Uniform Flat Burr & Anti-Overheating] Heavy-duty stainless steel flat burrs ensure even grinding for consistent extraction and richer flavor. Low-speed operation prevents overheating, preserving delicate oils and freshness.",
        "[2–12 Cup Quantity Control] Set your desired yield (2–12 cups) with the intuitive cup selector knob and 7 oz. bean hopper—grind just what you need, with zero waste."
      ],
      "bestseller_ranks": [
        {
          "rank": 68800,
          "category": "Home & Kitchen"
        },
        {
          "rank": 28,
          "category": "Burr Coffee Grinders"
        }
      ],
      "rating_scale": 5
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

返回字段

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被补造。

字段	含义
`asin`	Amazon 标准识别号，站内唯一商品标识。
`title`	标题。平台无标题概念时（如纯文本帖）为 null。
`url`	该记录在原平台上的可访问链接。
`brand`	品牌。
`price`	价格数值，不含货币符号；币种见 currency。
`list_price`	划线原价。
`currency`	价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
`rating`	评分。分制随平台而异，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
`rating_scale`	上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
`rating_count`	参与评分的人数。null 表示不公开，不等于 0。
`in_stock`	是否有货。
`category`	分类名称，取值为原平台的分类体系，未做跨平台归一。
`image_url`	图片链接。多图能力可能返回 image_urls 数组。
`description`	简介或描述，通常比 text 短。
`is_amazon_choice`	是否有 Amazon's Choice 标。
`seller_name`	卖家名称。
`platform`	数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
`images`	图片链接数组，按平台展示顺序；没有图片时不出现这个字段。
`features`	商品页上的卖点要点列表（search / profile），按页面原文；没有时没有这个字段。
`bestseller_ranks`	Best Sellers 排名列表（search / profile）：每项含 rank（名次）和 category（所在类目），同一商品在不同类目的名次分开列；是采集时的名次，不是销量。

常见问题

怎么搜英国、日本等其他站点？

用 domain 传站点域名，例如 amazon.co.uk、amazon.co.jp，不带 https:// 和路径；不传时默认 amazon.com。lang 只改变页面语言，不会切换站点。

`lang` 该怎么填？

只接受接口列出的语言代码，例如 en、ja、de；简体中文填 zhcn，繁体中文填 zhtw，不能写成笼统的 zh。语言只影响页面文字，不影响商品所在的站点。

搜到商品后怎么看评价？

用结果的 asin 拼出 https://www.amazon.com/dp/<ASIN> 这样的商品链接（换成搜索时的站点），传给 Amazon 的评价能力；非美国站还要在评价能力的 domain 里传同一个站点，否则按 amazon.com 读。

错误与计费

401: 缺少 Key 或 Key 无效。先鉴权再校验参数，未鉴权的请求拿不到参数结构。
422: 参数名或取值不对。错误信息会列出这项能力支持的参数、允许值和最接近的候选，按它改即可；发生在扣费之前。
402: 余额不足，请先充值。
429: 超过账户的每分钟请求上限（名下所有 Key 合计；Key 自设了更低上限时先按它算），按 Retry-After 等待后再试。需要更高上限可在控制台买提速包。
503: 暂时无法完成。已预扣的费用按原账本退回；响应里的 billing 与 refund 写明实际结果，结果未知时会明确标出，不要直接重发。
200 空结果: 请求完成但没有数据，不扣费（billing.reason = empty_result_refunded）。