Amazon 多个商品的共同关键词 API
暂不可用
我们正在恢复这项能力。在此之前调用通常会失败或没有结果；失败和空结果都不扣费。
接口健康状态
- 24h 健康值
- 正常
- 24h 平均耗时
- —
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
24 小时趋势
30 天趋势
多个商品的共同关键词：返回列表，默认 20 条、单次最多 100 条（传更大的数按 100 条返回）；主要字段 keyword、search_volume、ranked_at、rankings、total_keywords、platform。
多个商品的共同关键词按 asins 找出这几个商品都排得上的搜索关键词，每行是一个共同词，带月搜索量 search_volume，以及每个商品在这个词下的名次明细 rankings。想知道几个竞品共同在争哪些词、在同一个词下谁的价格和评分更有优势，从这个接口入手。
asins 放 2–10 个 ASIN，只查美国站，一个 ASIN 不够，至少要两个。rankings 按你传入 ASIN 的顺序排，每项含名次、结果类型（自然或广告）、标题、价格和币种、评分和评分数。
单价 $11.51 / 千次（每次 $0.01151），失败与空结果不扣费。 同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。
AI 提示词
请帮我用 EveryInfra 的「Amazon 多个商品的共同关键词」接口（amazon/keyword_intersections）写一个数据采集脚本。
接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 amazon，action 填 keyword_intersections，参数放在 params 里。
- 必填参数：
- asins：要比的商品 ASIN，2–10 个，数组或逗号分隔的字符串，每个是 10 位大写字母/数字。只查美国站；返回这些商品都排得上的关键词。
- 可选参数：
- limit：这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限照收，按上限返回。（默认 20）
- 返回一组记录，每条记录的主要字段：keyword（这个商品排得上的搜索关键词（ran…）、search_volume（该关键词在美国站的月搜索量估计（r…）、ranked_at（观察到这个名次的时间）、rankings（这组商品各自在该关键词下的名次（k…）、total_keywords（这个商品总共排得上多少个关键词（r…）。
- 示例请求体：
{
"platform": "amazon",
"action": "keyword_intersections",
"params": {
"asins": [
"B0C2JXSHSK",
"B0CM8STPNH"
]
}
}
- 计费：$11.51 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "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 | 是 | keyword_intersections | 能力标识，固定值。 |
asins | body.params | array | 是 | - | 要比的商品 ASIN，2–10 个，数组或逗号分隔的字符串，每个是 10 位大写字母/数字。只查美国站；返回这些商品都排得上的关键词。 |
limit | body.params | integer (1–100) | 否 | 20 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限照收，按上限返回。 |
代码示例
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": "keyword_intersections",
"params": {
"asins": [
"B0C2JXSHSK",
"B0CM8STPNH"
]
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。
asins 放 2–10 个 ASIN，只查美国站；一行是这些商品都排得上的一个关键词。
响应示例
这组示例参数还没有真实样例：这里只按接口定义列出响应结构和字段，值用 … 占位，不是一次真实调用的结果。
{
"id": "req_…",
"platform": "amazon",
"action": "keyword_intersections",
"results": [
{
"keyword": …,
"search_volume": …,
"ranked_at": …,
"rankings": …,
"total_keywords": …,
"platform": …
}
],
"count": …,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}返回字段
业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被补造。
| 字段 | 含义 |
|---|---|
keyword | 这个商品排得上的搜索关键词（ranked_keywords）。 |
search_volume | 该关键词在美国站的月搜索量估计（ranked_keywords），是整个词的需求，不是这个商品的流量；0 表示量太小。 |
ranked_at | 观察到这个名次的时间，ISO 8601、UTC（ranked_keywords）；不同关键词的观察时间不同，可能是几周前。 |
rankings | 这组商品各自在该关键词下的名次（keyword_intersections），按传入顺序，每项有 asin、search_rank、result_type（organic 自然 / sponsored 广告）、title、price、currency、rating、rating_count。 |
total_keywords | 这个商品总共排得上多少个关键词（ranked_keywords），或这组商品一共有多少个共同关键词（keyword_intersections）；每行相同，一次最多返回 100 个。 |
platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
常见问题
rankings 里的顺序和 asins 有什么关系？
一致。rankings 按传入 asins 的顺序列出每个商品在这个词下的情况，所以第一项对应你传的第一个 ASIN，每项里也带着 ASIN，可以直接对号。
ranked_at 为什么每个词不一样？
它是观察到这个名次的时间，ISO 8601、UTC。不同关键词的观察时间不同，可能是几周前，所以名次是各自某一刻的快照，不是同一时刻的并排对比。
total_keywords 比返回的行数多是什么意思？
在这个接口里，它是这组商品一共有多少个共同关键词，不是单个商品的关键词数，每行的值相同。一次最多返回 100 个共同词，所以 total_keywords 大于返回行数，就说明有共同词没在这次结果里。
错误与计费
- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足，先充值。
- 422
- 参数名或取值不对，按错误信息给的候选改；不扣费。
- 429
- 超过每分钟请求上限，按 Retry-After 等待后再试。
- 503
- 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
- 200 空结果
- 没有数据，不扣费。