Amazon Reports API 自动化获取销售数据

对于亚马逊跨境电商运营而言，销售数据是店铺决策、库存管理、广告优化的核心依据。传统手动下载报表、整理数据不仅耗时易出错，还无法支撑实时分析。借助 Amazon Reports API（SP‑API 报告接口） 可实现销售数据全自动拉取、解析与入库，大幅提升运营效率。

一、接口基础认知

Amazon Reports API 属于 Selling Partner API（SP‑API） 核心模块，用于替代旧版 MWS Reports，支持订单、销量、流量、库存、广告等多维度报表程序化获取。

支持报表类型：订单报表、销售汇总、流量转化、库存健康、退货明细等
数据格式：CSV/TSV/XML/JSON
调用模式：创建报告 → 轮询状态 → 下载解析 → 数据入库
权限要求：卖家后台授权 + 开发者凭证 + 角色权限

二、前期准备（必做）

注册亚马逊开发者账号，创建安全配置文件
获取凭证：
- Client ID
- Client Secret
- Refresh Token
- Seller ID
- Marketplace ID（站点 ID）
开通 Reports API 权限并完成店铺授权
安装依赖（以 Python 为例）

plaintext

复制代码

pip install sp-api requests python-dotenv pandas

三、标准自动化流程

1. 配置凭证与初始化

python

运行

复制代码

from sp_api.api import Reports
from sp_api.base import Marketplaces
import time
import pandas as pd

# 凭证配置
config = {
    "refresh_token": "你的refresh_token",
    "client_id": "你的client_id",
    "client_secret": "你的client_secret",
    "aws_access_key": "你的aws_access_key",
    "aws_secret_key": "你的aws_secret_key"
}

reports_api = Reports(**config)

2. 创建销售报告请求

常用销售报表类型：

GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_GENERAL：订单明细
GET_SALES_AND_TRAFFIC_REPORT：销量 + 流量汇总
GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE：结算报告

python

运行

复制代码

# 创建报告
response = reports_api.create_report(
    reportType="GET_SALES_AND_TRAFFIC_REPORT",
    marketplaceIds=[Marketplaces.US.marketplace_id],
    dataStartTime="2026-01-01T00:00:00Z",
    dataEndTime="2026-03-29T23:59:59Z"
)

report_id = response.payload.get('reportId')
print(f"报告创建成功，ID: {report_id}")

3. 轮询报告状态

亚马逊报表为异步生成，需轮询等待完成。

python

运行

复制代码

def check_report_ready(report_id):
    while True:
        res = reports_api.get_report(report_id=report_id)
        status = res.payload.get('processingStatus')
        if status == 'DONE':
            return res.payload.get('reportDocumentId')
        elif status in ['CANCELLED', 'FAILED']:
            raise Exception(f"报告生成失败：{status}")
        print("等待报告生成中...")
        time.sleep(60)

document_id = check_report_ready(report_id)

4. 下载并解析报表

python

运行

复制代码

# 获取下载信息
doc_info = reports_api.get_report_document(document_id)
download_url = doc_info.payload.get('url')

# 下载并读取
df = pd.read_csv(download_url)
# 保存本地
df.to_csv("amazon_sales_data.csv", index=False)
print("销售数据已保存")

5. 定时自动化（可选）

配合 Linux crontab 或 Windows 任务计划程序，实现每日 / 每周自动拉取。

四、常见问题与优化

调用频率限制
- 控制请求间隔，避免触发限流
- 批量合并报告请求
时区与时间格式
- 统一使用 UTC 时间
- 按站点时区做数据转换
数据清洗
- 去重、空值处理、字段重命名
- 按 ASIN / 日期 / 站点聚合
安全建议
- 凭证使用环境变量或配置文件管理
- 避免硬编码上传至代码仓库

五、应用价值

自动生成日报 / 周报 / 月报
实时监控销量、流量、转化率
对接 BI 工具做可视化看板
支撑广告投放、库存补货、定价策略
替代第三方付费工具，降低成本

六、总结

Amazon Reports API 是亚马逊精细化运营的标准数据底座。通过 Python 实现自动化拉取，可把运营从重复报表工作中解放，让数据真正驱动决策。建议从单站点、单报表开始落地，逐步扩展到全店铺、全品类、全周期自动化数据体系。