Ads API 申请第 4 步:获取 Profile ID 并做一次验证调用
Profile ID 代表「某个站点的广告账户」,几乎每个 Ads API 请求都要带上它。它不在任何后台页面上直接显示,需要用刚拿到的凭证调用一次 /v2/profiles。
拿到 Profile ID 并验证(可点击任一步)
示例值均为占位;请求在你自己的电脑上执行。
怎么查 Amazon Ads API 的 Profile ID?
用 Refresh Token 换取 access token
你的电脑 → Windows PowerShell用 grant_type=refresh_token、refresh_token、client_id、client_secret 调用 token 端点,返回新的 access token,refresh token 保持不变 [5]。access token 有效期 60 分钟 [6]。
$t = Invoke-RestMethod -Method Post -Uri 'https://api.amazon.com/auth/o2/token' -Body @{grant_type='refresh_token'; refresh_token='你的RefreshToken'; client_id='你的ClientID'; client_secret='你的ClientSecret'}
调用 GET /v2/profiles
https://advertising-api.amazon.com/v2/profiles请求头只需要 Amazon-Advertising-API-ClientId 与 Authorization: Bearer [1]:
Invoke-RestMethod -Uri 'https://advertising-api.amazon.com/v2/profiles' -Headers @{'Amazon-Advertising-API-ClientId'='你的ClientID'; 'Authorization'=('Bearer ' + $t.access_token)} | ConvertTo-Json -Depth 5
选出美国站的 Profile ID
返回结果每个 profile 代表一个站点的广告账户,包含 countryCode、currencyCode、timezone 等字段 [2]。选 countryCode 为 US、accountInfo.type 为 seller 的那一项,记下它的 profileId。
同一条记录里的 accountInfo.marketplaceStringId 就是站点的 Marketplace ID,美国站为 ATVPDKIKX0DER [7];accountInfo.id 是卖家账户标识,请与卖家中心显示的商家令牌(Seller ID)核对一致后再录入。
(可选)做一次验证调用
POST https://advertising-api.amazon.com/sp/campaigns/list官方首次调用示例中,SP 使用 POST sp/campaigns/list,没有广告活动时返回 200 和空数组 [8]。这一次要带上 profile scope 请求头 [4]:
Invoke-RestMethod -Method Post -Uri 'https://advertising-api.amazon.com/sp/campaigns/list' -Headers @{'Amazon-Advertising-API-ClientId'='你的ClientID'; 'Amazon-Advertising-API-Scope'='你的ProfileID'; 'Authorization'=('Bearer ' + $t.access_token); 'Accept'='application/vnd.spCampaign.v3+json'} -ContentType 'application/vnd.spCampaign.v3+json' -Body '{}'
只在自己的电脑上执行,不要把含密钥的命令粘贴到在线工具或聊天软件。
录入中转客户端
中转客户端 · 本机设置页把 Ads API 的 Client ID、Client Secret、Refresh Token 与 Profile ID,连同 SP-API 的凭证、Marketplace ID 与 Seller ID 一起录入。Profile ID、Marketplace ID、Seller ID 为必填项;它们是账户标识,不是登录或调用凭证,系统计算需要,会同步一份到云端。录入方法见 安装中转客户端并录入凭证。
Ads API 各区域端点(本系统目前只支持北美)
| 区域 | API 主机 | 覆盖站点 | 琼仁智度 |
|---|---|---|---|
| 北美 NA | https://advertising-api.amazon.com | 美国、加拿大、墨西哥、巴西 [3] | ✓ 支持(以美国站为主) |
| 欧洲 EU | https://advertising-api-eu.amazon.com | 英国、法国、意大利、西班牙、德国等 [3] | — 仅供参考,目前不支持 |
| 远东 FE | https://advertising-api-fe.amazon.com | 日本、澳大利亚、新加坡 [3] | — 仅供参考,目前不支持 |
/v2/profiles 只返回所调用区域的 profile,例如只有日本站的账号调用北美端点会得到空数组 [2]。
Profile ID 查不到或调用报错怎么办?
| 现象 | 官方含义 | 怎么处理 |
|---|---|---|
| /v2/profiles 返回 [] | 授权成功,但授权账号在该区域没有 View and Edit 权限 [1] | 确认调用的是北美主机;用有美国站广告管理权限的账号重新授权 [9] |
| 401 Unauthorized | 缺少或写错授权头,或 access token 已过期 [10][6] | 检查 ClientId 头与 Bearer 前缀;重新换取 access token |
| 401,提示缺少 Scope 头 | 除 /v2/profiles 外的请求缺少 profile scope [10] | 把 Profile ID 放进 Amazon-Advertising-API-Scope |
| 401,找不到与 scope 匹配的广告主 | Profile ID 写错,或与广告主不匹配 [10] | 重新核对 profileId,确认调用的是同一区域主机 |
| 403 Forbidden | 无权访问指定资源 [10] | 检查授权账号在卖家中心的广告相关权限 [9] |
| 429 Too Many Requests | 请求过多,响应带 Retry-After [11] | 按 Retry-After 等待后指数退避重试 |
Profile ID 是机密吗?
不是。Profile ID 是广告账户的标识,不能单独用来调用 API;每次请求还需要 Client ID 与 access token [4]。真正需要保密的是 Client Secret 与 Refresh Token。
凭证归你。SP-API 与 Amazon Ads API 都由你以自己的名义申请,Client Secret 与 Refresh Token 属于你本人。亚马逊政策要求不得共享访问密钥或密码,也不得索取他人的访问密钥 [12][13]。琼仁智度的设计是:凭证只录入你电脑上的中转客户端并加密保存在本机,云端从不接收、从不存储;所有发往亚马逊的请求都从你自己的网络发出。授权方式与数据流向的完整说明见 API 授权与数据说明。
下一步:了解 365 天重新授权
① 创建安全配置文件
在 developer.amazon.com 创建 Login with Amazon 安全配置文件。
打开这一步 →② 申请并分配访问
以直接广告主身份申请,获批后把访问分配给你的应用。
打开这一步 →③ 授权并换取 Token
同意授权,5 分钟内用授权码换取 Refresh Token。
打开这一步 →④ Profile ID 与验证
调用 /v2/profiles 取美国站 Profile ID,做一次验证调用。
⑤ 365 天重新授权
记下到期日、按时重新授权、撤销授权与错误排查。
打开这一步 →Ads API 接通后,琼仁智度用它帮你做什么?
有了 Ads API 凭证与 Profile ID,PPCWISER 琼仁智度就能读取你的搜索词、版位与广告报告,并在利润约束内调整出价与关键词:
- 按关键词 × 时段 × 版位分配出价——见 168 时段分时出价、版位溢价自动反推
- 先保护、再否定的自动否词;稳定出单的搜索词自动提取为精准投放——见 自动否定词、自动提取精准词
- 出价、版位溢价与分时规则同一轮下发,每次调价都有可读的原因——见 三合一安全下发
小时级的流量与转化来自 Amazon Marketing Stream,需要你用自己的 AWS 账号接收 [14],见 AWS 与 Marketing Stream 教程。算法按统一的广告结构运行,接入时二选一:重构现有系列(方案 A)或保留原系列另建标准结构(方案 B),见 广告结构说明。不想自己摸索?API 申请协助(¥499/次):你本人操作,我们远程指导。
Profile ID 常见问题
Ads API 调用 /v2/profiles 返回空数组是什么原因?
返回了好几个 profile,选哪一个?
Profile ID 需要保密吗?
调用接口报 401 怎么办?
没有品牌备案,能用 Sponsored Brands 吗?
凭证准备好,就可以开始 30 天免费试用
全部功能开放,试用期不收订阅费;之后入门版 ¥99/月/店铺(含 10 个产品),每多 1 个产品 +¥10/月。API 不想自己摸索?申请协助 ¥499/次,你本人操作、我们远程指导。
相关功能
365 天重新授权
记下 365 天到期日、按时重新授权、撤销授权与常见错误排查。
查看 →接入教程安装中转客户端
Windows 电脑双击安装、配对码上线,在本机设置页录入全部凭证,凭证不离开这台电脑。
查看 →AWS 教程AWS 小时级数据
5 步把亚马逊小时级广告数据接进你自己的 AWS,再交给中转客户端只读读取。
查看 →服务API 申请协助
¥499/次:你本人操作,我们远程指导 SP-API 与 Ads API 申请。
查看 →Ads APIAds API 申请
Ads API 申请 5 步:安全配置文件、申请分配、授权换 Token、Profile ID、365 天续期。
查看 →参考资料与权威来源
本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文;访问日期 2026-09。
- [1]官方Step 3: Retrieve a profile ID — Amazon Ads API Docs · 2026调用 GET /v2/profiles(请求头只需 Amazon-Advertising-API-ClientId 与 Authorization: Bearer)获取 profileId;返回空数组表示授权账号在该区域没有 View and Edit 权限。
- [2]官方Profiles — Amazon Ads API Docs · 2026每个 profile 代表一个站点的广告账户(含 countryCode、currencyCode、timezone 等);/v2/profiles 只返回所调用区域端点的 profile;卖家使用 Sponsored Brands 与 Sponsored Display 需要品牌注册。
- [3]官方Amazon Ads API overview(API endpoints) — Amazon Ads API Docs · 2026Ads API 三个区域主机:北美 advertising-api.amazon.com(US、CA、MX、BR)、欧洲 advertising-api-eu.amazon.com、远东 advertising-api-fe.amazon.com。
- [4]官方Amazon Ads API authorization overview — Amazon Ads API Docs · 2026客户端(获批的 LwA 应用)必须经广告主通过 Login with Amazon 显式授权,才能访问该广告主的数据;每次请求需带 Client ID、access token 与 profile scope 请求头。
- [5]官方Refresh tokens — Amazon Ads API Docs · 20262026-07-30 及以后签发的 refresh token 自广告主同意之日起 365 天到期,到期日不因使用而延长,到期后须重新授权;撤销授权、移除应用、修改 LwA 凭证或可疑活动也会使其失效并返回 invalid_grant;建议加密保存并在到期前提醒重新授权。
- [6]官方Access tokens — Amazon Ads API Docs · 2026Ads API 的 access token 有效期为 60 分钟,过期后需用 refresh token 重新获取。
- [7]官方Store Identifiers(Marketplace IDs) — Amazon Selling Partner API Docs · 2026北美区域 Marketplace ID:美国 ATVPDKIKX0DER、加拿大 A2EUQ1WTGCTBG2、墨西哥 A1AM78C64UM0Y8、巴西 A2Q3Y263D00KWC;许多 SP-API 操作需用它指定目标站点。
- [8]官方Make your first call to the Amazon Ads API — Amazon Ads API Docs · 2026首次调用示例:SP 用 POST sp/campaigns/list,没有广告活动时返回 200 和空数组。
- [9]官方Permissions — Amazon Ads API Docs · 2026卖家账户的 API 权限来自卖家中心用户权限中的 Campaign manager、Product Ads Performance Reports 等项;授权账号缺少对应权限时 API 返回 401。
- [10]官方Error responses and error status codes — Amazon Ads API Docs · 2026Ads API 错误说明:401 可能是缺少 Scope 请求头、profile 与广告主不匹配或无权访问该 scope;403 表示无权访问指定资源。
- [11]官方Rate limiting — Amazon Ads API Docs · 2026请求过多时返回 429 并带 Retry-After 头,限流随系统负载动态调整,官方建议指数退避重试。
- [12]官方Acceptable Use Policy(SP-API) — Amazon Seller Central · 2026SP-API AUP:2.2 须对授权用户清楚、诚实地说明访问哪些数据及用途;提交给亚马逊的材料须准确;3.1 不得共享访问密钥或密码;3.2 不得出于任何目的索取或接收授权用户的访问密钥;3.3 不得索要卖家中心用户名密码;3.5 连续 90 天无成功调用的访问密钥会被删除;3.8 不得申请应用功能用不到的数据。
- [13]官方Data Protection Policy / Acceptable Use Policy(Amazon Ads API) — Amazon Ads · 2026Ads API 数据政策:切勿共享密钥或密码,切勿出于任何目的索要或接受广告参与者的访问凭证,不申请用不到的访问,应用须每 365 天重新取得用户同意,发现安全事件 24 小时内报告。
- [14]官方Amazon Marketing Stream overview — Amazon Ads API Docs · 2026Amazon Marketing Stream 以推送方式近实时提供小时级广告流量与转化数据。