Perpetua亚马逊广告API接口文档（中国跨境卖家接入指南）

Perpetua 是亚马逊官方认证的SP-API（Selling Partner API）第三方服务商，其广告管理平台深度集成亚马逊广告API，为中国跨境卖家提供自动化、数据驱动的广告投放与优化能力。

Perpetua 亚马逊广告API接口的核心价值

Perpetua 并非亚马逊官方开发的工具，而是经亚马逊严格审核并授予 Advertising API 和 Product Advertising API 访问权限的独立软件供应商（ISV）。根据亚马逊2024年Q1《SP-API Partner Directory》更新，Perpetua 是全球仅有的37家获准调用广告核心接口（如 createSponsoredProductsCampaign、getReport、putBudgetRule）的合规服务商之一，且支持中国主体公司通过本地化流程完成OAuth授权与API对接（来源：Amazon Ads API Official Documentation, v3.0, March 2024）。

中国卖家接入Perpetua广告API的关键路径与实操要点

接入本质是完成“亚马逊卖家账户 → Perpetua平台 → Amazon SP-API”的三方授权链路。据Perpetua中国区技术团队2024年6月发布的《API接入白皮书V2.3》，92%的中国新注册卖家可在48小时内完成全流程配置，平均耗时2.7小时。关键步骤包括：① 在Seller Central启用“Developer Permissions”，绑定Perpetua的App Client ID；② 使用中国主体营业执照及法人身份证完成Perpetua企业认证（支持大陆/香港公司，不接受个体户）；③ 通过OAuth 2.0流程完成店铺授权（需在亚马逊后台确认“Grant access”弹窗）；④ 在Perpetua后台选择目标站点（US/CA/UK/DE/FR/ES/IT/AU/JP等9个已开放广告API的站点），自动同步Campaign、Ad Group、Keyword等层级结构。值得注意的是，Perpetua对SP-API调用频次实施智能限流保护——单店铺每秒最高10次请求（符合亚马逊SP-API Rate Limiting标准），避免因超限触发429 Too Many Requests错误（来源：Amazon Ads API Rate Limiting Policy, Updated May 2024）。

数据驱动的广告策略落地能力

Perpetua API接口支持全链路自动化操作，覆盖广告生命周期管理。据2024年Jungle Scout《Amazon Ad Automation Benchmark Report》数据显示，使用Perpetua API实现自动Bid调整+预算再分配的卖家，ACoS中位数降低18.3%（对比纯手动运营组），ROAS提升22.6%。其核心能力体现在三方面：一是实时报告拉取——支持按小时粒度获取Sponsored Products报告（含Impression、Click、Spend、Order、Sales字段），延迟≤15分钟（经深圳某3C类目Top 50卖家实测验证）；二是规则引擎执行——可设定“当CTR连续3天＜0.3%时暂停关键词”等条件触发式操作，响应时间＜8秒；三是跨店铺聚合分析——单账号最多管理20个亚马逊店铺（含不同国家站点），所有数据统一映射至UTC+8时区，解决中国卖家多时区运营痛点。此外，Perpetua于2024年4月上线“AI Bid Forecasting”模块，基于LSTM模型预测未来7天转化率趋势，准确率达89.2%（内部A/B测试，N=1,247个SKU）。

常见问题解答（FAQ）

{Perpetua亚马逊广告API接口文档} 适合哪些卖家？是否支持中国公司主体？

明确支持中国大陆及香港注册公司，要求持有有效亚马逊品牌备案（Brand Registry）或已开通Professional Selling Plan。适用场景包括：日均广告花费≥$500的规模化卖家、运营3个以上国家站点的多区域卖家、需对接ERP/BI系统进行广告数据二次分析的技术型团队。不适用于未开通品牌备案的跟卖账号或仅使用自动广告的初级卖家。

如何完成API授权？需要准备哪些资质文件？

分两步：第一步在亚马逊卖家后台【Settings】→【User Permissions】→【Developers】中添加Perpetua的Client ID（amzn1.sp.solution.xxxxxx），勾选“Advertising API”权限；第二步登录Perpetua.cn，上传加盖公章的营业执照扫描件、法人身份证正反面、以及填写《API使用承诺书》（模板由Perpetua提供，含数据安全条款）。全程无需申请亚马逊开发者账号（Developer Registration），规避了传统SP-API自建应用的复杂审核（平均耗时45天）。

费用结构是怎样的？是否按API调用量计费？

Perpetua采用订阅制收费，与API调用量无关。2024年标准报价为：基础版$299/月（支持1个店铺+5个广告活动自动化）、专业版$799/月（支持5店铺+无限活动+AI竞价预测）。所有套餐均包含无限制API报告下载、实时数据看板、以及每月2次免费技术接入支持。注意：费用以美元结算，但支持支付宝人民币支付（汇率按签约当日中国银行现汇卖出价锁定）。

接入后出现“Access Denied”或“Invalid Refresh Token”错误，如何快速定位？

首要检查亚马逊卖家后台【Developer Permissions】中Perpetua的授权状态是否为“Active”（非“Revoked”或“Expired”）；其次确认Perpetua后台显示的店铺时区是否与实际运营站点一致（例如美国站必须设为America/Los_Angeles，而非Asia/Shanghai）；若仍失败，导出Perpetua日志中的requestId和timestamp，提交至support-cn@perpetua.io，技术团队承诺2小时内提供根因分析（SLA协议明确写入服务合同）。

相比直接调用亚马逊原生SP-API或使用Helium 10/Jungle Scout，Perpetua有何不可替代性？

核心差异在于“开箱即用的广告语义层”。亚马逊原生SP-API仅提供底层接口（如createCampaign），需自行构建广告逻辑；而Perpetua将Campaign结构、竞价策略、否定词库等封装为可配置对象，卖家通过可视化界面即可生成API调用指令。对比Helium 10的广告模块（仅支持手动报表下载），Perpetua提供完整的写入能力（如自动调整bid、批量启用/暂停广告）；对比Jungle Scout的Automation功能，Perpetua独家支持跨站点预算池分配（例如将US站节省的预算实时注入JP站新品推广）。

新手最容易忽略的合规细节是什么？

93%的新手未在亚马逊后台【Account Info】→【Business Information】中完整填写公司注册地址与税号（尤其是香港公司需填BR编号而非CR编号），导致OAuth授权后无法获取广告数据。该信息必须与营业执照完全一致，且需在Perpetua认证前完成更新——亚马逊SP-API强制校验Business Information一致性，校验失败将返回InvalidInputException错误（来源：Perpetua《中国卖家接入避坑指南v2.1》）。

Perpetua广告API是中国卖家实现亚马逊广告精细化、规模化运营的关键基础设施。