如何通过App Store Connect API获取全球及各区域销售报告？

核心说明 #

销售报告API本身没有regionCode筛选参数，你当前默认拿到欧洲数据，是因为账号关联的默认销售区域为欧洲。要获取全球或其他区域数据，可参考以下方案：

方案1：使用filter[countryCode]参数（官方支持） #

销售报告API支持通过filter[countryCode]指定单个国家/地区代码，获取对应区域的数据。比如要获取美国区域的销售报告，请求示例如下：

GET https://api.appstoreconnect.apple.com/v1/salesReports?filter[reportDate]=2024-09&filter[reportType]=SALES&filter[vendorNumber]=xxxxx&filter[frequency]=MONTHLY&filter[reportSubType]=SUMMARY&filter[countryCode]=US

如果需要全球数据，你需要遍历所有Apple支持的国家/地区代码，逐个发起请求后自行合并数据。国家/地区代码可在App Store Connect后台的销售报告设置页面查看。

方案2：修改账号默认销售区域（单一区域需求适用） #

若你只需要固定某一个非欧洲区域的数据，可以在App Store Connect后台的「付款与财务报告」设置里，修改默认的销售报告区域。修改完成后，调用salesReports API会默认返回该区域的数据，但这种方式只能设置一个默认区域，无法直接获取全球数据。

方案3：切换报告子类型（部分场景可用） #

当前你使用的reportSubType是SUMMARY，可以尝试切换为DETAILED类型，部分情况下详细报告会包含更广泛的区域数据，但效果取决于你的账号权限和业务范围。

注意事项 #

• 遍历国家代码批量请求时，要注意App Store Connect API的速率限制，避免触发限流导致请求失败。
• 合并多区域数据时，要注意排查重复订单数据，避免统计误差。

内容的提问来源于stack exchange，提问作者Ahmed Ashraf