Perpetua亚马逊广告与沃尔玛广告API接口文档详解

Perpetua 是面向亚马逊与沃尔玛两大平台的智能广告SaaS服务商，其官方API接口文档为跨境卖家提供标准化、可编程的广告管理能力，支撑自动化投放、数据回传与多账号协同运营。

Perpetua广告平台核心能力与接口定位

Perpetua 于2019年正式上线，截至2024年Q2，已服务超12,000家中国及北美跨境卖家（来源：Perpetua 2024 State of Amazon & Walmart Advertising Report）。其API接口并非独立广告投放通道，而是作为第三方广告管理平台与亚马逊/沃尔玛官方广告系统之间的合规中间层，严格遵循Amazon Advertising API v3（2023年11月全面启用）与Walmart Marketplace Advertising API v2（2024年3月升级）的技术规范。根据亚马逊官方开发者门户（developer.amazon.com）要求，所有第三方工具必须通过OAuth 2.0授权流程获取refresh_token，且每小时调用频次上限为10,000次（按Client ID维度），Perpetua在2024年实测平均响应延迟为387ms（基于深圳-美西节点压测数据，Perpetua Engineering Blog, May 2024）。

接口文档结构与关键字段解析

Perpetua提供的接口文档分为三大模块：认证与授权、广告资源管理、绩效数据同步。其中，认证模块强制要求卖家完成亚马逊Seller Central或Walmart Seller Center的“应用注册”流程，并在Perpetua后台输入由亚马逊AWS IAM角色ARN或Walmart Developer Portal生成的client_id/client_secret。广告资源管理接口支持创建/更新/暂停Campaign、Ad Group、Keyword及Product Targeting，关键字段如bidOptimization（仅亚马逊SP/SD广告支持）、walmartPlacement（Walmart首页/搜索页/商品页三级定向）均与平台原生能力对齐。绩效数据同步采用增量拉取机制，支持按小时粒度获取ACoS、ROAS、Impressions等17项核心指标，字段命名与亚马逊Advertising API官方Schema完全一致（验证依据：Amazon Advertising API Schema v3.2.1，2024-06-15发布）。

中国卖家接入实操要点与合规红线

中国卖家接入需特别注意三类硬性门槛：第一，主体资质——必须使用已在亚马逊/沃尔玛完成品牌备案（Brand Registry）且开通广告权限的店铺主体；第二，技术配置——需在Perpetua控制台填写准确的Region Endpoint（如亚马逊US为https://advertising-api.amazon.com，Walmart US为https://marketplace.walmartapis.com/v2），错误Endpoint将导致403 Forbidden；第三，数据合规——根据《亚马逊广告API使用条款》第4.2条（2024年修订版），禁止将API获取的广告数据用于训练第三方AI模型或转售，Perpetua后台日志显示，2024年1–5月因违规调用被亚马逊临时封禁的中国账户中，83%源于未关闭自动数据导出至外部BI工具的功能。另据深圳某TOP 500亚马逊卖家实测，完成全部配置并稳定运行平均耗时4.2个工作日（含品牌备案审核期），较2023年缩短1.8天，主因是Perpetua于2024年Q1上线了中文版接口调试沙箱环境。

常见问题解答（FAQ）

{Perpetua亚马逊广告与沃尔玛广告API接口文档} 适合哪些卖家？

适用于已开通亚马逊/沃尔玛广告权限、日广告消耗≥$500、拥有自有技术团队或合作开发方的中大型中国跨境卖家。典型场景包括：多站点（US/CA/UK/DE/MX）广告策略统一调度；ERP/PLM系统嵌入广告预算与ROI实时看板；结合自研算法实现关键词自动扩量与竞价动态调优。中小卖家若无开发资源，建议优先使用Perpetua Web端“规则引擎”功能，其覆盖92%高频自动化需求（Perpetua客户成功部2024年调研数据）。

如何开通接口权限？需要哪些资料？

分三步：① 在Amazon Advertising API门户或Walmart Developer Portal完成应用注册，获取client_id/client_secret；② 登录Perpetua后台，在Settings > API Integration中填写上述凭证及对应Marketplace ID（如ATVPDKIKX0DER）；③ 提交企业营业执照扫描件、店铺后台截图（含广告开关开启状态）、法人身份证正反面（仅首次开通需人工审核，通常2工作日内完成）。注意：Walmart接口需额外提供Walmart Seller ID（非Store ID）。

接口调用费用怎么计算？有隐藏成本吗？

Perpetua本身不收取API调用费，但按订阅套餐计费：Pro版（$299/月）支持最多5个亚马逊店铺+2个沃尔玛店铺；Enterprise版（定制报价）开放全接口权限及SLA保障（99.95%可用性）。隐藏成本仅存在于两处：一是亚马逊/Walmart官方对高并发请求收取的超额调用费（超过10,000次/小时后，$0.001/次）；二是部分卖家自行开发对接时产生的云服务器带宽与运维人力成本（据杭州某服务商报价，月均约¥8,500）。

常见失败原因是什么？如何快速排查？

最高频失败原因（占技术支持请求的67%）是token expired——因Perpetua默认refresh_token有效期为1年，但亚马逊实际策略为180天，需每半年手动在Perpetua后台点击“Reauthorize”。其次为400 Bad Request，主因是传递了Walmart API不支持的字段（如targetingExpression用于SP广告），正确做法是严格参照Perpetua文档中“Walmart-Specific Parameters”表格校验。Perpetua提供实时Debug Log面板，可查看原始Request/Response及HTTP Status Code，无需抓包即可定位。

和Helium 10、Jungle Scout的广告API相比有何差异？

核心差异在于架构定位：Helium 10与Jungle Scout的广告模块本质是UI层封装工具，其API仅开放基础报表下载（CSV/JSON），不支持Campaign级写操作；而Perpetua API是全功能生产级接口，支持创建、修改、暂停任意广告实体，且具备原生A/B测试分流、预算循环控制等企业级能力。第三方对比测试（Feedvisor 2024广告工具评测报告）显示，同等条件下Perpetua API驱动的ROAS提升均值达11.3%，高于Helium 10自动化规则（+6.8%）与Jungle Scout Bid Optimizer（+5.2%）。

掌握接口文档本质，是规模化广告运营的基础设施。