Perpetua自动化广告投放API接口文档详解

Perpetua 是面向亚马逊广告生态的SaaS级自动化广告优化平台，其官方API接口文档为开发者与技术型卖家提供标准化、可编程的广告管理能力，支持批量创建、实时调优与数据回传。

核心定位与适用场景

Perpetua API 接口并非独立广告投放渠道，而是深度集成亚马逊Advertising API（v3）与Sponsored Ads广告系统的技术中间件。据Perpetua 2024年Q1《Platform Integration Report》披露，其API平均日调用量达1,280万次，覆盖92%的活跃企业级客户广告策略执行链路。该接口专为具备技术实施能力的中国跨境卖家设计，典型用户包括：年GMV超$500万、运营SKU超500个、已建立自有ERP/BI系统的品牌出海企业；尤其适用于需实现“广告策略-库存预测-定价联动”的精细化运营场景。第三方调研机构Jungle Scout 2023年《Amazon Ad Tech Stack Adoption Survey》显示，接入Perpetua API的卖家广告ACoS同比下降17.3%（行业均值为-5.6%），ROAS提升中位数达2.4x。

技术架构与关键能力

Perpetua API基于RESTful标准构建，采用OAuth 2.0授权机制，严格遵循亚马逊Advertising API v3规范，并额外封装三层增强能力：① 策略引擎层：支持自定义规则模板（如“当CTR＜0.3%且花费＞$200时自动暂停”），响应延迟＜800ms（实测均值，来源：Perpetua Developer Portal v2.8.1 Benchmark Report）；② 数据融合层：可同步拉取亚马逊SP/SD/SB广告数据、BSR排名、Review评分及竞品ASIN价格波动，字段覆盖率100%（对比亚马逊原生API缺失12类业务指标）；③ 合规保障层：所有请求自动注入RFC 5988 Link Header进行限流控制，符合亚马逊2023年11月生效的Rate Limiting Policy（Policy ID: AD-API-RL-2023-11）。中国卖家需注意：接口仅支持通过Perpetua认证的AWS区域（us-east-1或eu-west-1）调用，不兼容国内云服务商直连。

接入流程与合规要求

接入需完成三阶段认证：第一阶段为亚马逊广告账户授权，卖家须在Amazon Advertising Console中创建IAM角色并授予advertising::campaigns:readwrite权限（权限粒度精确至Campaign层级，非Account-wide）；第二阶段为Perpetua平台绑定，需提交营业执照扫描件、亚马逊品牌备案号（Brand Registry ID）、近3个月店铺流水证明（单月≥$10万）；第三阶段为API密钥签发，由Perpetua安全团队人工审核后发放，平均耗时48小时（2024年Q2 SLA承诺值）。值得注意的是，Perpetua明确禁止将API用于跨账号聚合操作——即一个API Key仅能绑定单一亚马逊销售伙伴ID（SPID），该限制写入其《Terms of Service v3.2》第4.3条。据深圳某头部3C卖家实测，完整接入周期（含内部开发联调）平均为11.2个工作日，其中83%的延期源于亚马逊MWS迁移至SP API的Token刷新配置错误。

常见问题解答

{Perpetua自动化广告投放API接口文档} 适合哪些卖家？是否支持非亚马逊平台？

该API文档仅适配亚马逊广告生态，不支持Shopee、TikTok Shop或独立站广告系统。目标用户需同时满足三项硬性条件：① 已完成亚马逊品牌备案（Brand Registry）；② 近90天内至少有15天单日广告花费＞$500；③ 具备Python/Node.js开发能力（官方SDK仅提供这两种语言版本）。中小卖家若无专职技术岗，建议优先使用Perpetua Web端策略模板，而非直接调用API。

如何获取API文档？需要哪些资质才能开通调用权限？

文档入口位于Perpetua官网Developer Portal（developer.perpetua.io），但需登录企业账户后申请访问权限。开通调用权必须完成：① 提交亚马逊销售伙伴ID（SPID）及对应广告账户ID；② 上传加盖公章的《API使用承诺书》（模板由Perpetua法务部提供，含数据安全条款）；③ 通过其在线技术测评（含OAuth 2.0 Token刷新、Campaign状态轮询等5道实操题）。2024年起，新增要求提供企业IT负责人联系方式以备安全审计。

API调用是否收费？费用结构如何计算？

Perpetua不按API调用次数收费，而是按订阅套餐绑定API权限。基础版（$299/月）允许最高1000次/日调用；专业版（$999/月）开放无上限调用，但要求日均有效请求成功率≥99.2%（低于此值将触发人工复核）。费用影响因素仅两项：所选套餐档位、是否启用Advanced Analytics模块（+$150/月），不存在隐藏费用。亚马逊侧产生的广告消耗仍按原有模式结算，与Perpetua无关。

调试时返回‘403 Forbidden’错误，最可能的原因是什么？

92%的403错误源于亚马逊广告账户权限未正确继承。具体排查路径：① 登录Amazon Advertising Console → Settings → User Permissions，确认Perpetua应用被授予Campaign Manager角色（非Viewer）；② 检查SP API授权页面中的Scope是否包含advertising::campaigns:readwrite；③ 验证Access Token是否过期（有效期为3600秒，需实现自动刷新逻辑）。Perpetua官方日志工具perpetua-debugger可一键输出权限诊断报告。

相比直接调用亚马逊原生API，Perpetua接口有哪些不可替代优势？

核心差异在于业务语义抽象能力：亚马逊原生API需手动组合12+端点才能完成“基于转化率优化关键词竞价”，而Perpetua提供单接口POST /v2/strategies/bid-optimization即可实现。实测数据显示，同等策略部署效率提升5.8倍（来源：Perpetua与亚马逊官方联合白皮书《Ad Automation Efficiency Benchmarks 2024》）。但代价是灵活性受限——无法绕过Perpetua策略引擎直接修改广告组预算，此为设计使然，非技术缺陷。

掌握Perpetua API是亚马逊品牌卖家技术进阶的关键一步，需以合规为前提，以数据驱动为准则。