Performance Reports

Flat File Feedback Report

reportType Value: GET_SELLER_FEEDBACK_DATA

Role: Selling Partner Insights, Amazon Fulfillment

Availability: Sellers

Requested/scheduled: This report can only be requested.

Report output type: Tab-delimited flat file

Contains negative and neutral feedback (one to three stars) from buyers who rated the seller's performance.

XML Customer Metrics Report

reportType Value: GET_V1_SELLER_PERFORMANCE_REPORT

Role: Selling Partner Insights

Availability: Sellers

Requested/scheduled: This report can only be requested.

Report output type: XML

Contains select, individual performance metrics data from the Seller Central dashboard.

Seller Performance Report

reportType Value: GET_V2_SELLER_PERFORMANCE_REPORT

Role: Selling Partner Insights

Availability: Sellers

Requested/scheduled: This report can only be requested.

Contains the individual performance metrics data from the Seller Central Account Health dashboard.

Promotions Performance Report

reportType Value: GET_PROMOTION_PERFORMANCE_REPORT

Schema: promotionReport

Role: Selling Partner Insights, Brand Analytics

Availability: Sellers who have the Selling Partner Insights Selling Partner API role and vendors who have the Brand Analytics Selling Partner API role who are also registered in Amazon's Brand Registry.

Requested/scheduled: This report can only be requested.

Report output type: JSON

Contains data from promotion campaigns to help sellers and vendors optimize their promotions and adjust their advertising strategies. The report includes sales from promotions, the types of discounts that were offered, and how many items were sold as a result of the promotions. Currently, three promotion types are supported for vendors (Best Deal, Lightning Deal, and Price Discount), and two promotion types are supported for sellers (Best Deal and Lightning Deal).

This report accepts the following reportOptions values:

• promotionStartDateFrom. The start of a date and time range (in ISO 8601 date time format) used for selecting promotions to report on. Be sure to specify the time zone: either UTC or an offset from UTC.
• promotionStartDateTo. The end of a date and time range (in ISO 8601 date time format) used for selecting promotions to report on. Be sure to specify the time zone: either UTC or an offset from UTC. Example: "reportOptions": {"promotionStartDateFrom": "2020-11-23T15:33:26Z", "promotionStartDateTo": "2020-12-06T15:33:26Z" }

Requests must include the promotionStartDateFrom and promotionStartDateTo in the reportOptions. All promotions with a start date-time that fall within the range of promotionStartDateFrom and promotionStartDateTo will be included.

Report behaviors:

• If a selected promotion is in progress when you request a report, the report will contain cumulative data for the promotion up until the day prior to your report request.
• A report will contain complete information on a selected promotion if the promotion ended one day or more before the time you requested the report.
• This report supports start dates up to two years before the current date.
• Data for this report is updated on a daily basis, so some fields might not reflect the most up-to-date state of the promotion.

{
  "reportSpecification":{
    "reportType":"GET_PROMOTION_PERFORMANCE_REPORT",
    "reportOptions":{
      "promotionStartDateFrom":"2020-11-23T15:33:26Z",
      "promotionStartDateTo":"2020-12-06T15:33:26Z"
    },
    "marketplaceIds":["ATVPDKIKX0DER"]
  },
  "promotions":[
    {
      "promotionId":"16913551269",
      "promotionsApiMappingId":"7b62d8d9-bfd4-465d-acb5-fa993ee57197",
      "promotionName":"Save on BrandX Product Name",
      "marketplaceId":"ATVPDKIKX0DER",
      "merchantId":"A21CXK3C4ERTY",
      "type":"BEST_DEAL",
      "status":"APPROVED",
      "glanceViews":41084,
      "unitsSold":121,
      "revenue":32917.01,
      "revenueCurrencyCode":"USD",
      "startDateTime":"2021-11-23T08:00:00Z",
      "endDateTime":"2021-11-30T07:59:59Z",
      "createdDateTime":"2021-10-15T12:00:00Z",
      "lastUpdatedDateTime":"2021-11-30T08:00:00Z",
      "includedProducts":[
        {
          "asin":"B08XJWMYR5",
          "productName":"BrandX Product Name",
          "productGlanceViews":41084,
          "productUnitsSold":121,
          "productRevenue":32917.01,
          "productRevenueCurrencyCode":"USD"
        }
      ]
    }
  ]
}

Seller Coupons Performance Report

reportType Value: GET_COUPON_PERFORMANCE_REPORT

Schema: sellerCouponReport

Role: Brand Analytics

Availability: Sellers

Requested/scheduled: This report can only be requested.

Report output type: JSON

Contains data from coupons to help sellers optimize their promotions and adjust their advertising strategies. The report includes coupon-level details (start/end date, clips, redemptions, budget information, and sales).

This report accepts the following reportOptions values:

• couponStartDateFrom - The start of a date and time range in ISO 8601 date time format used for selecting coupons to report on. Be sure to specify the time zone: either UTC or an offset from UTC.
• couponStartDateTo - The end of a date and time range in ISO 8601 date time format used for selecting coupons to report on. Be sure to specify the time zone: either UTC or an offset from UTC.

Example: "reportOptions": {"couponStartDateFrom": "2020-11-23T15:33:26Z","couponStartDateTo": "2020-12-06T15:33:26Z"}

Requests must include the couponStartDateFrom and couponStartDateTo in the reportOptions. All coupons with a start date-time that falls within the range of couponStartDateFrom and couponStartDateTo will be included.

Report behaviors:

• If a selected coupon is in progress when you request a report, the report will contain cumulative data for the coupon up until the day prior to your report request.
• A report will contain complete information on a selected coupon if the coupon ended one day or more before the time you requested the report.
• This report supports start dates up to two years before the current date.
• Data for this report is updated on a daily basis, so some fields might not reflect the most up-to-date state of the coupon.

Vendor Coupons Performance Report

reportType Value: GET_COUPON_PERFORMANCE_REPORT

Schema: vendorCouponReport

Role: Brand Analytics

Availability: Vendors

Requested/scheduled: This report can only be requested.

Report output type: JSON

Contains data from coupon campaigns to help vendors optimize their promotions and adjust their advertising strategies. The report includes campaign-level details (total clips, redemptions, budget type) and coupon-level details (start/end date, clips, redemptions, and budget information).

This report accepts the following reportOptions values:

• campaignStartDateFrom - The start of a date and time range in ISO 8601 date time format used for selecting coupon campaigns to report on. Be sure to specify the time zone: either UTC or an offset from UTC.
• campaignStartDateTo - The end of a date and time range in ISO 8601 date time format used for selecting coupon campaigns to report on. Be sure to specify the time zone: either UTC or an offset from UTC.

Example: "reportOptions": {"campaignStartDateFrom": "2020-11-23T15:33:26Z","campaignStartDateTo": "2020-12-06T15:33:26Z"}

Requests must include the campaignStartDateFrom and campaignStartDateTo in the reportOptions. All campaigns with a start date-time that fall within the range of campaignStartDateFrom and campaignStartDateTo will be included. The start date-time of a campaign is considered to be the earliest start date-time of any of its coupons.

Report behaviors:

• If a selected campaign is in progress when you request a report, the report will contain cumulative data for the campaign up until the day prior to your report request.
• A report will contain complete information on a selected campaign if the campaign ended one day or more before the time you requested the report.
• This report supports start dates up to two years before the current date.
• Data for this report is updated on a daily basis, so some fields might not reflect the most up-to-date state of the campaign.