Sales and commission for your brand's products

curl --request GET \
  --url https://api.example.com/reports \
  --header 'Authorization: Bearer <token>'

{
  "total_count": 123,
  "fetched_count": 123,
  "rows": [
    {
      "asin": "<string>",
      "product_name": "<string>",
      "date": "<string>",
      "marketplace": "<string>",
      "country_code": "<string>",
      "currency": "<string>",
      "creator": "<string>",
      "brand_id": "<string>",
      "brand_name": "<string>",
      "sales": 0,
      "conversions": 0,
      "unitsSold": 0,
      "clicks": 0,
      "addToCarts": 0,
      "detailPageViews": 0,
      "commissionPaid": 0,
      "brandReferralBonus": 0
    }
  ],
  "next_cursor": "<string>"
}

Reports

Sales and commission for your brand's products

Brand-side performance reporting. See how your products are selling across Amazon and how much commission you’re paying out to creators promoting them.

What you’ll see

You get one row for every combination of day, product, marketplace and creator. Each row tells you what the creator drove that day: how many people clicked, how many added the product to their cart, how many bought, and how much you paid out in commission.

Filtering

start and end — required date range (inclusive). Either YYYY-MM-DD or YYYYMMDD works.
marketplace — restrict to one Amazon marketplace. Pass all or omit for every marketplace.
asins — comma-separated ASINs to focus on specific products.
brand_ids — comma-separated brand ids. Only useful if you own more than one brand and want to drill into a subset.
creators — comma-separated creator identifiers if you want to see what specific creators drove.

What’s in the numbers

Sales, conversions, units sold, add-to-carts and detail page views include the linked product itself plus any other items from your brand the shopper bought. Sale amounts come back in the marketplace’s native currency — no currency conversion is applied.

Paging through results

Use limit (1–500, default 100) and take next_cursor from the response to fetch the next page. When next_cursor is null, you’ve seen everything.

GET

reports

Sales and commission for your brand's products

curl --request GET \
  --url https://api.example.com/reports \
  --header 'Authorization: Bearer <token>'

{
  "total_count": 123,
  "fetched_count": 123,
  "rows": [
    {
      "asin": "<string>",
      "product_name": "<string>",
      "date": "<string>",
      "marketplace": "<string>",
      "country_code": "<string>",
      "currency": "<string>",
      "creator": "<string>",
      "brand_id": "<string>",
      "brand_name": "<string>",
      "sales": 0,
      "conversions": 0,
      "unitsSold": 0,
      "clicks": 0,
      "addToCarts": 0,
      "detailPageViews": 0,
      "commissionPaid": 0,
      "brandReferralBonus": 0
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

start

string

required

First day of the report (inclusive). Use YYYY-MM-DD or YYYYMMDD.

Example:

{
  "iso": { "value": "2026-05-01" },
  "compact": { "value": "20260501" }
}

end

string

required

Last day of the report (inclusive). Use YYYY-MM-DD or YYYYMMDD.

Example:

{
  "iso": { "value": "2026-05-31" },
  "compact": { "value": "20260531" }
}

marketplace

string | null

Limit results to one Amazon marketplace — e.g. amazon.com, amazon.co.uk, amazon.de. Use all or leave blank to include every marketplace.

asins

string | null

Limit results to one or more products by ASIN. Separate multiple ASINs with commas.

brand_ids

string | null

Limit results to specific brands you own. Separate multiple ids with commas.

creators

string | null

Limit results to specific creators by identifier. Separate multiple with commas.

limit

integer

default:100

How many rows to return per page (1–500). Defaults to 100.

Required range: 1 <= x <= 500

cursor

string | null

Use next_cursor from the previous response. Leave blank for the first page.

Response

Successful Response

The response from GET /sellers/reports.

total_count

integer

required

Total rows matching your filters across every page.

fetched_count

integer

required

Rows in this page.

rows

SellerReportRow · object[]

required

The performance rows for this page.

Show child attributes

next_cursor

string | null

Pass this back as cursor to fetch the next page. Null when you're on the last page.

⌘I

Documentation Index

Authorizations

Query Parameters

Response