在亚马逊 SP-API 中国开发者大会现场,笔者结合实测数据与官方发布内容,对当前 API 能力进行了全面梳理。通过公共开发者应用对真实北美店铺授权进行只读测试,覆盖 SP-API 与 Ads-API 共 160 个接口,剔除无效与受限项,总结出今年最具运营价值的新增能力。
测试结果显示:SP-API 85 个接口中 75 个可用,Ads-API 75 个接口中 72 个可用。被拒接口多涉及买家隐私、VC 专属或需特殊资质项目,普通 FBA 卖家无需关注。
认证流程已简化为 LWA 一层,refresh token 换 access token,不再需要 AWS 签名。原计划 2025 年实施的公共开发者收费政策已于今年 5 月取消,目前免费开放。各接口均设限流机制,是实际使用中的主要门槛。
从深圳服务器直连北美端点,平均响应时间三四百毫秒,无超时现象。以下聚焦今年新增且对运营有实质帮助的七大核心更新。
一、新版订单接口:十步并作两步,收入拆分实时可见
旧版获取完整订单信息需调用十个接口,新版仅保留“搜索订单”与“查询单详情”两个操作。通过 includedData 参数可一次性获取收入拆分、费用、促销、取消、配送、包裹、税项、支付及 Easy Ship 订单号等全部字段。
其中“收入拆分”字段尤为关键,支持按类型展示每项小计,使运营能在周会中即时回答“某 SKU 上周 200 单实际入账多少”,无需等待财务月末报表。
7 月更新新增“取消执行方式”与“面单打印窗口”字段。注意:旧版订单接口已于 1 月宣布淘汰,FBA 订单中买家邮箱字段亦被移除,新工具开发应直接采用新版。
二、促销 API 上线:秒杀、优惠券效果首次可量化
此前促销活动缺乏 API 入口,预算消耗与效果只能手动后台查看。两周前上线的促销 API 提供三个核心操作:
- searchPromotions:按条件检索,返回标题、预算、日期、状态、优惠力度、ID、商城及费用快照(前置费、抽成比例、封顶值);
- getPromotion:按 ID 获取完整数据;
- getProductSelection:分页获取参与商品列表,支持超 100 件,每件带专属优惠。
最具价值的是“验证问题”字段——接口直接返回促销未通过的具体原因(如价格不符、库存不足、近期已打折等),彻底解决运营反复排查痛点。
虽暂不支持创建促销(预计年底上线),但已实现“花费 - 效果 - 失败原因”全链路闭环分析,为自动化工具立项提供坚实基础。
三、财务接口升级:结算汇总、余额明细、放款时间精准预测
7 月新增“结算周期汇总”与“账户余额”接口,前者按周期展示净收入及拆分项,后者区分可用、预留、递延、账户级预留四类余额。
同日上线的“预计放款”接口返回下一笔款项的 scheduledDate、金额及收款卡尾号,终结“大概月中到账”的模糊答复。
另:交易流水自 1 月起支持按订单号筛选,可追溯单笔订单所有收支明细。
四、多渠道配送 MCF 新版:货件信息一次拉全
7 月发布的 MCF 新版本支持在订单列表中直接嵌入货件详情,一次性返回 34 个字段,包括状态、配置、地址、行项目与货件信息。独立站或多平台卖家若使用 FBA 发货,建议优先接入新版。
五、竞品价格与相似商品:官方数据免费开放
5 月正式推出的“相似商品”接口支持任意 ASIN 查询,不限本店商品。输入一个 ASIN 可返回 6-7 个官方认定的相似品,层层递归可构建完整竞品图谱。
配合 includedData 参数,还可同步获取竞品三大价格维度:
- featuredBuyingOptions:Buy Box 现价、持有者、会员分段价;
- referencePrices:划线价 WasPrice 与竞争价 CompetitivePrice;
- lowestPricedOffers:各卖家最低报价、运费、是否 FBA。
批量测试 14 个竞品 ASIN 均成功返回,限流每 30 秒一次,适合搭建监控工具。7 月更新 further 在每个报价下增加 promotions 字段(促销类型、折扣额、折后价),虽本次测试未命中_active_促销,但字段结构已确认存在。
Listing 接口 7 月起支持跨站点查询(如美加同步),便于多站点调价前比对。至此,免费、权威、实时的竞品监控成为可能。
六、供应链追踪与通知过滤:外部货件可视,消息推送定制
8 月新增追踪接口,支持凭承运商单号、集装箱号、提单号查询外部渠道货件里程碑与预计送达时间,并配套新通知类型。
5 月更新通知系统,支持编写过滤表达式,仅订阅特定类型的订单变更,避免信息过载。仍需自备 AWS 队列接收推送。
七、Data Kiosk:自定义分析结果,非原始数据
Data Kiosk 区别于传统接口(取记录)与报表接口(取固定表),允许用户自定义查询维度、指标与粒度,由亚马逊后台聚合后返回结果文档。
例如:可指定“近 7 天按日”粒度,提取销售额、件数、退款率、Sessions、页面浏览、Buy Box 占比、转化率等 19 个字段,一行一天,无需自行拼接。
当前两大数据集:
- 销量流量:含 Sessions、转化率、退款率等,支持按日/周/月、父/子 ASIN/SKU 回溯两年,今年新增 B2B 相关指标;
- 经济学:每个 ASIN 的销售额、佣金、FBA 费、仓储费、广告费、净收益及费用变更预估,相当于官方“单品利润”计算器。
适用场景:周报生成、单品利润核算。局限:非实时(隔天数据)、无调度功能、需品牌备案角色、无订单明细。
其他年度更新速览
- 订阅省接口:4 月起支持 offer 级指标,5 月起可按 ASIN/SKU/品牌筛选至天粒度;
- 报表与 Feed:4 月新增下载自动解压参数;
- 入库货件:7 月起送达窗口含折扣字段,助力成本优化;
- 商品类型定义:5 月起支持按单品/子体/父体分别拉取 schema。
能力易得,架构难建:从“能调”到“有用”的关键跃迁
授权流程极简:生成链接→同事点击同意→token 自动回调,全程无需代码,一分钟完成。AI 可在十余分钟内完成 85 个接口探测与表格生成,技术门槛几乎为零。
真正的瓶颈在于限流:报表创建约 1 分钟/次,新版订单搜索 3 分钟/次,财务流水 0.5 次/秒。这要求系统必须设计为夜间自动运行、本地存储、晨间展示的模式,尤其对搜索词等 65 天过期数据更需每日抓取存档。
解决方案架构师(SA):工具价值的核心定义者
大会揭示趋势:人人皆可开发者,差异在于“设计思路”。工具是否真正有用,取决于是否贴合业务场景。
以“FBA 货件自动化”为例:
- 痛点:运营每票货需手动抄录箱号、追踪码、下载箱标,耗时 20-40 分钟;
- 方案:不建“管理系统”,只做两件事——①识别仓库可发数据自动创建货件;②回拉计划、箱单、箱标打包输出 Excel+PDF;
- 成果:首票 51 箱仅用 2 分钟创建 +41 秒输出,准确率 100%,每周节省 N 小时人力。
SA 的核心职责:
- 翻译业务痛点为技术方案;
- 基于 API 设计对接流程;
- 绘制架构图与数据流;
- 评估限流、安全、成本;
- 推动落地并排查问题。
关键原则:工具必须长在用户现有动作上,而非增加新步骤。验收标准唯一:“明天谁用?在哪用?替掉哪步手工?省多少时间?”四问必答,否则搁置。
Ads-API 年度更新概览
广告体系独立授权,本次同样基于真实账号测试 48 个接口,聚焦今年新增:
1. 新账号模型(6 月 GA)
支持一国账号映射多国,旧接口将于 2027 年 7 月关停,新项目必须迁移。
2. 品类基准(5 月全球 GA)
提供品牌在类目中的曝光、CTR、ACOS、ROAS 前三档对比(前 25%、中位、后 25%),让“表现不错”有了官方参照系。
3. 官方 MCP Server(2 月开放测试)
将账号、AMC、账单、活动、报表等封装为 AI 可调用的工具,附带十余个官方 skill,OAuth 2.1 已支持,AI 管广告已成现实。
重要变更提醒
- SB 广告位负向竞价调整于 6 月 15 日废止,仅保留正向;
- 刷新令牌过期策略 5 月 26 日更新,长期授权 SaaS 必阅;
- 统一活动管理接口去年 12 月 GA,一套模型管 SP/SB/SD/ST,代表未来方向。
结论:广告 API 与 SP-API 同趋——读权限全开,写权限够用,新特性全面拥抱 AI 直连。
实测能力表获取说明
文中提及的两份实测表(SP-API 85 行、Ads-API 71 行)详细记录每个接口的用途、返回字段、实测状态与限流值,不含任何店铺数据,可作为自建工具的起点。
获取方式:点赞、推荐、分享本文,并留言"API",将通过私信发送《SP-API 实测能力表》与《Amazon-Ads-API 实测能力表》。
结语:亚马逊已敞开大门,钥匙就在手中。选择切入哪一扇门,比拥有钥匙更重要。你的第一刀,准备切在哪里?
by 于新

