亚马逊 API 接入教程:开通琼仁智度前,你需要准备这 4 样东西
SP-API 与 Amazon Ads API 需要你以自己的名义申请,官方流程分散在好几个网站、全是英文、有几处一步错就要找支持团队重置。这里把 4 样东西拆成逐步教程:为什么需要、难在哪里、要花多少钱、下一步点哪里。
4 样东西:为什么需要、难度、费用
难度是我们根据官方流程环节多少给出的经验评估;费用与耗时以官方页面为准。
SP-API 凭证
为什么:订单、退款、FBA 库存与退货、业务报告、价格与促销、费用、目录与 A+ 数据,用来算真实利润和订单保护。费用:目前不收费(以官方最新公告为准)。
SP-API 申请教程 →难度 ★★Amazon Ads API 凭证
为什么:读取搜索词、版位与广告报告,调整出价、版位溢价与分时规则,创建广告与否定词。费用:官方接入文档未提及申请费用。
Ads API 申请教程 →难度 ★★★AWS + Marketing Stream
为什么:小时级流量与转化数据,是按时段、版位 × 时段出价的数据基础。费用:亚马逊不收 Stream 费用,AWS 按用量计费(需可国际支付的银行卡)。
AWS 与 Stream 教程 →难度 ★一台 Windows 电脑
为什么:运行中转客户端,凭证只存在这台电脑、请求从你的网络发出。要求:Windows 10/11、管理员权限、预装 Python 3.10+、计算与下发时段开机联网、独立宽带出口。
中转客户端安装 →亚马逊 API 接入要花多少钱、多长时间?
| 项目 | 在哪里申请 | 官方耗时 | 费用 | 最后要录入中转的内容 |
|---|---|---|---|---|
| SP-API | Solution Provider Portal(卖家中心 Develop Apps 会跳转过去)[7] | 身份验证审核最多 2 个工作日;标准角色资料审核通常 1–2 周 [4][5] | 目前不收费,以官方最新公告为准 [2] | LWA Client ID、Client Secret、Refresh Token、Marketplace ID、Seller ID |
| Amazon Ads API | developer.amazon.com(安全配置文件)+ advertising.amazon.com(申请)[8][6] | 申请结果最长 1 个工作日邮件通知 [6] | 官方接入文档未提及申请费用 | Client ID、Client Secret、Refresh Token、Profile ID |
| AWS + Marketing Stream | AWS 全球区账号 + 亚马逊广告 API 订阅 [3] | 以 AWS 开户与配置进度为准 | 亚马逊不收费;AWS 按用量计费 [3] | AWS 只读访问密钥、S3 桶名、路径与区域 |
| Windows 电脑 | 你自己的电脑 | 安装约几分钟 | 无额外费用 | 配对码(由顾问提供) |
Profile ID、Marketplace ID、Seller ID 为中转客户端的必填项。它们是账户标识而非登录或调用凭证,系统计算需要,会同步一份到云端。
按这个顺序做,最少走回头路
SP-API 与 Ads API 的审核可以并行:一边等 SP-API 开发者资料审核,一边完成 Ads API 的申请与授权。
确认账号条件
卖家中心 → 设置开发 SP-API 私有卖家应用需要专业销售账户,注册必须由主账号用户完成 [9]。准备公司注册号与地址、带照片证件、180 天内的地址证明 [10][4]。详见 准备资格与材料。
申请 SP-API
Solution Provider Portal注册并完成身份验证 → 提交私有开发者资料(最少的非受限角色、如实用例、安全问卷)→ 获批后创建应用并自授权,生成 Refresh Token。自 2023-10-02 起不再需要 AWS IAM 或签名 [11]。详见 SP-API 申请教程。
申请 Amazon Ads API
developer.amazon.com → advertising.amazon.com创建 Login with Amazon 安全配置文件 → 以直接广告主身份申请 → 点审批邮件把访问分配给应用 → 授权并换取 Refresh Token → 查 Profile ID [12][13]。详见 Ads API 申请教程。
配置 AWS 与 Marketing Stream(强烈建议)
AWS 控制台在你自己的 AWS 账号里接收 sp-traffic、sp-conversion、sb-traffic、sb-conversion 小时级数据集 [14]。详见 AWS 与 Marketing Stream 教程。
为什么要你自己申请?凭证交给谁?
凭证归你。SP-API 与 Amazon Ads API 都由你以自己的名义申请,Client Secret 与 Refresh Token 属于你本人。亚马逊政策要求不得共享访问密钥或密码,也不得索取他人的访问密钥 [15][16]。琼仁智度的设计是:凭证只录入你电脑上的中转客户端并加密保存在本机,云端从不接收、从不存储;所有发往亚马逊的请求都从你自己的网络发出。授权方式与数据流向的完整说明见 API 授权与数据说明。
这也是你需要准备一台 Windows 电脑的原因:中转客户端是凭证的保管处和请求的出口,停掉它,云端就无法再操作你的账户。
在 SP-API 开发者资料的用例栏、Ads API 申请表的用途说明里,请如实说明你使用 PPCWISER 软件管理自己店铺的广告、软件在你自己电脑上运行、凭证不离开本机。亚马逊政策要求对数据用途清楚、诚实地说明 [15]。不要写「无第三方参与」。各页都附有如实填写范本。
开始之前,把这些账号和材料放在手边
接入教程目录
SP-API 申请(5 步)
准备材料 → SPP 注册与身份验证 → 开发者资料 → 建应用与自授权 → 轮换与排错。
从第 1 步开始 →Amazon Ads API 申请(5 步)
安全配置文件 → 申请并分配 → 授权换 Token → Profile ID → 365 天重新授权。
从第 1 步开始 →AWS + Marketing Stream
注册 AWS、创建 S3 与 Firehose、订阅数据集、只读访问密钥、验证数据到达。
查看教程 →中转客户端安装
双击安装、配对、在本机设置页录入凭证与账户 ID。
查看教程 →API 申请协助 ¥499/次
你本人登录并亲自操作,我们远程指导逐栏填写;不索要、不接收任何密码与密钥。
了解协助服务 →API 授权与数据说明
凭证归属、数据流向、申请如何如实填写。
查看说明 →自己申请,还是请我们协助?
每一篇教程都按官方页面写到逐栏、逐个按钮,照着做可以免费完成。容易出问题的是这几处:身份验证资料与证件不一致(提交后不可修改,结果为最终决定)[4]、角色选多了拖长审核、点审批邮件链接时登录了错误账号导致链接失效 [20]、授权码 5 分钟过期 [21]。
如果你希望有人在旁边看着走完,可以选择 API 申请协助(¥499/次):你本人登录、亲自操作,我们远程指导填写;我们不会索要、接收或代存任何账号密码与密钥。审核结果由亚马逊决定。
接入常见问题
用琼仁智度需要自己申请亚马逊 API 吗?
申请亚马逊 SP-API 和广告 API 要花钱吗?
SP-API 和 Amazon Ads API 有什么区别,两个都要申请吗?
整个接入大概要多久?
支持欧洲站、日本站吗?
凭证准备好,就可以开始 30 天免费试用
全部功能开放,试用期不收订阅费;之后入门版 ¥99/月/店铺(含 10 个产品),每多 1 个产品 +¥10/月。API 不想自己摸索?申请协助 ¥499/次,你本人操作、我们远程指导。
相关功能
SP-API 申请
SP-API 私有应用申请 5 步:准备、注册验证、开发者资料、建应用自授权、轮换。
查看 →Ads APIAds API 申请
Ads API 申请 5 步:安全配置文件、申请分配、授权换 Token、Profile ID、365 天续期。
查看 →AWS 教程AWS 小时级数据
5 步把亚马逊小时级广告数据接进你自己的 AWS,再交给中转客户端只读读取。
查看 →接入教程安装中转客户端
Windows 电脑双击安装、配对码上线,在本机设置页录入全部凭证,凭证不离开这台电脑。
查看 →服务API 申请协助
¥499/次:你本人操作,我们远程指导 SP-API 与 Ads API 申请。
查看 →透明说明API 授权与数据说明
凭证归属、调用方式、处理哪些数据与用途、申请表如何如实填写。
查看 →参考资料与权威来源
本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文;访问日期 2026-09。
- [1]官方Ads + Selling Partner APIs Onboarding and Best Practices — Amazon Ads API Knowledge Hub · 2024TACOS = 广告花费 ÷ 总销售额(广告 + 自然),需要结合 Ads API 与 Selling Partner API 数据计算。
- [2]官方Cancellation of Third-Party Developer Selling Partner API (SP-API) Fees — Amazon Selling Partner Developer Services · 2026亚马逊宣布目前(at this time)不再推进 SP-API 使用费与年费,将从 Solution Provider Portal 移除费用预览,已登记的信用卡可删除。
- [3]官方Amazon Marketing Stream overview — Amazon Ads API Docs · 2026Amazon Marketing Stream 以推送方式近实时提供小时级广告流量与转化数据。
- [4]官方Verify Your Identity in Solution Provider Portal — Amazon Selling Partner API Docs · 2026所有 Solution Provider Portal 用户都须完成身份验证:政府签发的带照片证件 + 180 天内的地址证明(银行/信用卡账单或 Payoneer、World First、Alipay 等账单);信息须与文件完全一致,提交后不可修改,审核最多 2 个工作日,结果为最终决定。
- [5]官方Step 3: Create a Developer Profile — Amazon Selling Partner API Docs · 2026开发者资料包括联系信息、数据访问类型、角色、用例与安全控制问答;标准(非受限)角色审核通常 1–2 周,受限角色需经过业务、安全、技术三段审核。
- [6]官方Step 2: Apply for Amazon Ads API access — Amazon Ads API Docs · 2026直接广告主(Direct Advertiser)通过 about-api 页 Request API Access 或申请表提交;须用创建开发者账号时的同一邮箱登录;提交后最长 1 个工作日通过邮件通知结果。
- [7]官方Solution Provider Portal FAQ — Amazon Selling Partner API Docs · 2026开发者注册已迁移到 Solution Provider Portal,卖家中心的开发者入口会重定向到 SPP;SPP 为全球账户,界面显示账户位于美国属正常;身份验证对整个 SPP 账户只需做一次。
- [8]官方Step 1: Create a Login with Amazon application — Amazon Ads API Docs · 2026在 developer.amazon.com 创建 Login with Amazon 安全配置文件;已有 SP-API 凭证也须新建;每家公司只开通一个 Client ID,获批并接受协议后不能更换所绑定的 LwA 应用;建议使用多人共管的企业邮箱;直接广告主访问自己数据时隐私声明 URL 可填任意有效地址。
- [9]官方SP-API Registration Overview — Amazon Selling Partner API Docs · 2026开发 SP-API 私有卖家应用需要专业销售账户(个人账户不行);必须由主账号用户完成注册;开发者资料申请须原创、少于 500 词,不得照抄 AUP/DPP;安全控制问题应由负责数据安全的技术人员作答。
- [10]官方Step 1: Prepare for Registration — Amazon Selling Partner API Docs · 2026注册前需确定开发者类型(私有应用走简化审核、不上架 Appstore)与所需角色,并准备公司注册号与注册地址、政府签发证件或护照、近期银行或信用卡账单。
- [11]官方SP-API no longer requires AWS IAM or AWS Signature Version 4 — Amazon Selling Partner API Changelog · 2023自 2023-10-02 起,SP-API 不再要求 AWS IAM 资源与 AWS SigV4 签名,只需 LWA access token,适用于所有区域。
- [12]官方Amazon Ads API onboarding overview — Amazon Ads API Docs · 2026使用 Amazon Ads API 需要先创建 Login with Amazon 应用并申请 API 访问,再完成授权获取令牌。
- [13]官方Getting started with the Amazon Ads API — Amazon Ads API Docs · 2026开通后取凭证分三步:创建授权许可、换取 access 与 refresh token、获取 profile ID。
- [14]官方Sponsored Products performance datasets — Amazon Ads API Docs · 2026Marketing Stream 的 sp-traffic / sp-conversion 数据集以小时为粒度推送;首批点击数据 12 小时内送达,之后的无效点击修正会自动补推。
- [15]官方Acceptable Use Policy(SP-API) — Amazon Seller Central · 2026SP-API AUP:2.2 须对授权用户清楚、诚实地说明访问哪些数据及用途;提交给亚马逊的材料须准确;3.1 不得共享访问密钥或密码;3.2 不得出于任何目的索取或接收授权用户的访问密钥;3.3 不得索要卖家中心用户名密码;3.5 连续 90 天无成功调用的访问密钥会被删除;3.8 不得申请应用功能用不到的数据。
- [16]官方Data Protection Policy / Acceptable Use Policy(Amazon Ads API) — Amazon Ads · 2026Ads API 数据政策:切勿共享密钥或密码,切勿出于任何目的索要或接受广告参与者的访问凭证,不申请用不到的访问,应用须每 365 天重新取得用户同意,发现安全事件 24 小时内报告。
- [17]官方Rotate your Application's LWA Credentials — Amazon Selling Partner API Docs · 2026所有 SP-API 应用必须每 180 天轮换一次 LWA client secret,到期前 90 天收到通知;只有主账号用户能轮换;旧 secret 在生成新 secret 后 7 天失效;逾期未轮换调用会报错。
- [18]官方Step 2: Create a Solution Provider Portal Account — Amazon Selling Partner API Docs · 2026用 Amazon 账户登录 Solution Provider Portal → Register → Acknowledge & Continue → Program Enrollment → Solution Type Setup 选择 Build applications that use SP APIs → Verify your identity;需准备带摄像头的设备进行身份验证视频通话。
- [19]官方Permissions — Amazon Ads API Docs · 2026卖家账户的 API 权限来自卖家中心用户权限中的 Campaign manager、Product Ads Performance Reports 等项;授权账号缺少对应权限时 API 返回 401。
- [20]官方Step 3: Assign API access to a Login with Amazon application — Amazon Ads API Docs · 2026获批后点审批邮件链接,把 API 访问分配给 LwA 应用;点击前须退出其他所有 Amazon 账号,用错账号点击会使链接失效、只能由 API 支持团队重置;确认页显示 advertising::campaign_management 等 scope。
- [21]官方Getting started - Create an authorization grant — Amazon Ads API Docs · 2026在 LwA 安全配置文件的 Web Settings 中设置 Allowed Return URLs(直接广告主可用 https://amazon.com 并手动复制授权码);北美授权地址前缀为 https://www.amazon.com/ap/oa;授权码 5 分钟内有效且只能使用一次;授权账号可以与开发者账号不同。
- [22]官方An Update on SP-API Fees(2025-11-03 公告,Internet Archive 存档) — Amazon Selling Partner Developer Services · 20252025-11-03 亚马逊宣布拟向第三方开发者收取 SP-API 年费与 GET 调用使用费,并写明仅为自己业务直接使用 SP-API 的卖家不收取额外费用。
- [23]官方Getting Started with SP-API for Private Developers — Amazon Selling Partner Developer Services · 2026私有应用只供本组织使用、通过自授权接入,不在 Appstore 上架;开发私有卖家应用需要专业销售账户。