可通过 Amazon 销售合作伙伴获得的数据 API

亚马逊销售合作伙伴 API (SP-API) 是一个帮助亚马逊卖家和供应商以编程方式访问其订单、发货、付款等数据的REST基础API。由此获得的数据API可以提高销售效率，降低劳动力需求并缩短对客户的响应时间。本指南重点介绍您可以通过销售合作伙伴API获取报告（报告API）和销售合作伙伴（Data Kiosk）访问的数据。API API

报告 API

报告中的数据API旨在帮助您管理您在亚马逊商城上的业务。分析报告提供了有关您的产品、客户和整体绩效的宝贵见解，例如：

• 销售业绩-分析销售数据可以帮助您确定趋势和客户购买模式。您可以使用此信息来优化您的销售策略。

• 产品绩效 — 分析产品数据可以帮助您确定哪些产品畅销，哪些不畅销。您可以使用此信息来优化您的产品。

• 客户行为 — 分析客户数据可以帮助您了解客户的偏好和需求。您可以使用这些信息来个性化您的营销和销售策略。

下表说明了每份品牌分析报告。以下报告适用于具有品牌分析销售合作伙伴API角色且已在 “亚马逊品牌注册” 中注册的亚马逊卖家和供应商。

报告	描述	参数
市场篮子分析报告	在结账时提供有关最常与客户购物篮（购物车）中的商品组合购买的商品的数据	可以为不同的报告期（DAY、WEEKMONTH、或QUARTER）请求报告。这些数据是在这些时期内提供的。
Amazon 搜索词报告	包含商城中最常选择的亚马逊标准识别码 (ASINs) 的数据，按搜索关键词和部门划分	可以为不同的报告期（DAY、WEEKMONTH、或QUARTER）请求报告。请求不能跨越多个报告期。
重复购买报告	包含卖方重复购买商品的数量数据	可以为不同的报告期（WEEKMONTH、或QUARTER）请求报告。数据可以跨越多个报告期。

下表说明了每份供应商零售分析和卖家零售分析报告。

报告	描述	可用性	参数
快速零售分析库存报告	包含某个ASIN级别的库存数据，按每小时的粒度进行汇总	供应商	只能请求报告。数据可以跨越多个日期范围周期，包括当天。
快速零售分析流量报告	包含有关客户访问供应商商品详情页面的流量数据，按小时精细度排列	供应商	只能请求报告。数据可以跨越多个日期范围周期。
快速零售分析销售报告	包含某个ASIN级别的销售数据，按每小时精细度汇总	供应商	只能请求报告。数据可以跨越多个日期范围周期。
供应商销售报告	包含在目录级别和级别报告的关键零售销售指标（例如订购和发货的收入和数量）ASIN	供应商	可以针对不同的情况要求报告： 报告周期（DAYWEEK、MONTH、QUARTER、或YEAR） 分销商视图（MANUFACTURING或SOURCING） 销售计划（RETAILBUSINESS、或FRESH）
纯产品净利润率报告	包含亚马逊销售供应商商品的纯净产品利润率数据，这些数据在目录层面和目录层ASIN面上报告	供应商	可以为不同的报告期（DAY、、WEEKMONTHQUARTER、或YEAR）请求报告。
供应商流量报告	包含在目录级别和级别报告的关键零售流量指标，例如浏览次数 ASIN	供应商	可以为不同的报告期（DAY、、WEEKMONTHQUARTER、或YEAR）请求报告。
供应商预测报告	包含前瞻性平均值、之前的 70、之前的 80 周和之前的 90 周客户需求预测，按最近一周预测生成日期的ASIN水平报告	供应商	可以为不同的销售计划申请报告（RETAIL或FRESH）。
供应商库存报告	包含在目录级别和级别报告的库存和运营状况指标（例如可售的现有商品和供应商确认率）ASIN	供应商	可以针对不同的情况要求报告： 报告周期（DAYWEEK、MONTH、QUARTER、或YEAR） 分销商视图（MANUFACTURING或SOURCING） 销售计划（RETAIL或FRESH）
销售和流量业务报告	包含卖家整个目录的关键销售业绩指标（例如订购商品的销量、收入、订购的商品数量和索赔金额）和页面流量指标（例如页面浏览量和购买按钮百分比），按日期汇总和 ASIN	卖家	可以请求或安排报告。可以为不同的日期范围聚合级别（DAYWEEK、或MONTH）和ASIN聚合级别（PARENTCHILD、或SKU）提供数据。

数据亭 API

数据亭API提供基于 GraphQL 的动态报告套件。它可以帮助您生成自定义 GraphQL 查询并访问亚马逊数据集中的批量数据。您可以使用它API来访问各种数据，包括：

• 卖家销售和流量数据

• 供应商分析数据

• 卖家经济数据

以下是数据亭API的主要功能：

• GraphQL 支持的动态报告 — 支持 API GraphQL 查询操作，可帮助您创建自定义查询以检索所需的特定数据。

• 批量数据访问-您可以通过访问大型数据集API，从而便于进行全面的分析和报告。

• 灵活的数据探索 — 基于 GraphQL 的方法允许进行动态的临时数据探索。这种灵活性可以帮助您迭代查询并提取见解。

• 全面的数据覆盖范围 — API 提供对各种卖方和供应商数据的访问，从而实现全面的绩效分析和商业智能。

Data Kiosk 中的架构和指令API提供了一种通过 GraphQL 访问数据的结构化方式API，能够根据您的特定需求聚合和筛选数据。通过使用 Data KioskAPI，您可以对销售、流量和分析数据获得更深入、更具可操作性的见解。这使您能够做出明智的、以数据为导向的决策，以优化您的业务策略。

注意

查询的保留时间因请求的字段而异。架构中的每个字段都有一个指令注释，该@resultRetention指令定义了包含该字段的查询将保留多长时间。当查询包含多个保留期不同的字段时，将应用最短（最小）的保留期。查询结果文档的保留始终与查询的保留期相匹配。

卖家销售和流量数据

在 Data Kiosk 中API，Analytics_SalesAndTraffic_2024_04_24是销售和流量查询的根类型。此根类型有两个查询可用：

• salesAndTrafficByAsin检索按ASIN（PARENT、CHILD或SKU）汇总的销售和流量数据。

• salesAndTrafficByDate检索按日期（DAY、WEEK或MONTH）汇总的销售和流量数据。

请注意有关查询的以下内容：

• 枚举类型（枚举），例如AsinGranularity和DateGranularity，用于指定聚合级别。

• 标量类型（例如 Dat e）用于表示数据。

供应商分析数据

在 Data Kiosk 中API，Analytics_vendorAnalytics_2024_09_30是供应商分析查询的根类型。此根类型有两个视图可用：

• manufacturingView检索按指定日期汇总的有关您制造的商品的指标。

• sourcingView检索有关您直接向亚马逊采购的商品的指标，这些指标按指定日期汇总。

您可以根据分配给您的供应商（SOURCING或MANUFACTURING）角色访问相关视图及其关联指标。这些查询包括开始日期和结束日期、市场标识符、汇总指标和总指标。请注意有关查询的以下内容：

• 使用ManufacturingViewMetricsGroupedBy和SourcingViewMetricsGroupedBy类型按各种属性（例如ASIN或品牌）对指标进行分组。

• 指标类型，例如costs、customerSatisfactionorders、和productAvailability，代表不同的指标组。

• DateGranularity枚举指定了日期聚合的级别。

卖家经济数据

卖家经济报告全面介绍了您在亚马逊商城的业绩和财务状况。它涵盖了销售数据、广告支出、费用、成本和净收益。您可以按日期和产品标识符汇总数据。

在 Data Kiosk 中API，Analytics_Economics_2024_03_15是卖家经济学查询的根类型。给定商品的卖家经济数据由Economics类型表示。此类型包括以下关键方面：

• ads— 指定日期范围内产品的广告支出数据。

• cost— 卖家提供的此商品的 Amazon 折扣价格（每件）。

• fees— 在指定日期范围内对产品收取的费用。

• fnsku— 商品的配送网络库存单位 (FNSKU)。

• msku— 商品的卖家库存单位 (MSKU)。

• netProceeds— 该产品在指定日期范围内的净收益。

• sales— 指定日期范围内产品的销售数据。