亚马逊关键词调研工具API接口文档（2024最新版）

亚马逊官方未开放面向第三方的“关键词调研工具API”，当前所有合规可用的关键词数据能力均通过Amazon Advertising API（广告API）及Selling Partner API（SP-API）间接实现，需严格遵循AWS IAM权限模型与广告账户绑定机制。

核心接口能力与权威数据来源

根据亚马逊2024年3月发布的Amazon Advertising API v3官方文档，关键词调研功能仅存在于Keyword Suggestion和Search Term Report两类端点中。前者基于广告主历史投放词+类目热度生成建议词（非实时搜索量），后者需开启广告活动并积累≥7天曝光后方可导出真实搜索词报告。据2024年Q1《Jungle Scout亚马逊卖家年度报告》显示，使用Search Term Report的TOP 10%卖家平均ACoS降低23.6%，关键词相关性得分提升41%（基于Brand Analytics关键词表现模块校验）。

合规接入路径与技术要求

接入必须完成三重认证：① SP-API角色授权（需在Seller Central申请Advertising权限策略）；② Amazon Advertising账户绑定（要求账户已启用至少1个活跃Campaign）；③ AWS IAM角色配置（必须启用ads:Read和reports:CreateReport最小权限）。据亚马逊开发者门户2024年5月更新说明，新注册应用默认禁用keyword-suggestions端点，需单独提交Use Case Justification Form并通过人工审核（平均审核周期为5.2个工作日，数据来源：Amazon Ads API FAQ）。

实操关键参数与避坑指南

调用/keyword-suggestions时，searchTerm字段必须为英文且长度≤50字符；marketplaceIds仅支持US/CA/UK/DE/FR/ES/IT/NL/SE/AU/JP等11个已开通广告API的站点（不含中东、拉美等新兴站点）；返回结果中searchVolume为相对热度值（0–100），非绝对搜索量——该定义已在2024年2月API文档v3.1.0中明确标注（见Section 4.2.3）。中国卖家实测发现：未绑定品牌注册（Brand Registry）的账号，其Search Term Report中品牌词占比下降67%（样本量N=1,243，数据来源：知无不言《2024亚马逊广告API深度测评白皮书》）。

常见问题解答（FAQ）

{关键词} 适合哪些卖家？是否支持非广告主？

仅限已开通Amazon Advertising账户并有历史广告消耗（≥$100）的卖家。个人卖家、未绑定信用卡的账户、无广告活动记录的账号无法调用任何关键词相关端点。品牌备案（Brand Registry）非强制但强烈建议——未备案账号无法获取brand-search-term维度数据，影响竞品词分析精度。

{关键词} 怎么开通？需要哪些资质文件？

开通流程分四步：① 在Amazon Ads Developer Console创建应用；② 提交企业营业执照（中国大陆公司需提供加盖公章的英文翻译件）及法人身份证正反面；③ 在Seller Central完成SP-API角色授权（路径：Settings → User Permissions → Developer Permissions）；④ 绑定AWS IAM角色。全程无需支付预审费用，但需确保广告账户余额≥$50以触发自动验证。

{关键词} 的费用怎么计算？是否存在隐藏成本？

Amazon Advertising API本身免费，但关键词数据调用受广告账户预算约束：每次/keyword-suggestions请求消耗0.1个API配额（每日基础配额5,000次）；生成Search Term Report按报告类型计费——标准报告免费，自定义维度报告（如按ASIN+关键词交叉分析）收取$0.02/份（2024年价目表第7条）。无订阅费、无流量费，但未及时清理过期报告将占用存储配额（上限500份），超限后新报告生成失败。

调用失败常见原因及排查步骤是什么？

92.3%的失败源于权限配置错误（据2024年Q1亚马逊Ads技术支持工单统计）。标准排查链路：① 检查refresh_token是否过期（有效期1年，需每11个月轮换）；② 验证IAM角色是否附加AmazonAadAAPIFullAccess托管策略；③ 使用GET /v2/profiles确认广告账户状态为ACTIVE；④ 查看响应头x-amzn-RequestId并提交至Seller Support获取原始错误码（如403 Forbidden: insufficient permissions需重新授权SP-API角色）。

与Helium 10、Jungle Scout等第三方工具相比有何差异？

优势：数据源直连亚马逊广告后台，Search Term Report含真实转化率（CR）、加购率（Add-to-Cart Rate）等核心指标，第三方工具仅能估算；劣势：无历史趋势图（需自行存储7日以上报告做对比）、不支持多关键词批量拓词（单次最多5个种子词）。据2024年4月MerchantWords横向测评，API返回的长尾词覆盖率比第三方高38%，但头部词（月搜量＞10万）的CPC预估误差率达±22%（因未接入Seller Central库存与定价数据）。

新手最容易忽略的技术细节是什么？

忽略reportSchedule的时区设置：所有报告生成时间按UTC时区计算，中国卖家若未在请求体中显式指定dataStartTime为UTC+0，将导致报告覆盖时段错位（如本意取5月1日0点–5月7日24点，实际获取到的是4月30日16点–5月7日16点）。该问题占新手调试失败案例的61%（数据来源：知无不言开发者社区2024年5月问卷）。

严格遵循亚马逊广告API规范，是获取高质量关键词数据的唯一合规路径。