Sales, commission and traffic for your links

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

{
  "total_count": 123,
  "fetched_count": 123,
  "rows": [
    {
      "asin": "<string>",
      "date": "<string>",
      "marketplace": "<string>",
      "country_code": "<string>",
      "currency": "<string>",
      "commissionEarned": 0,
      "sales": 0,
      "conversions": 0,
      "clicks": 0,
      "addToCarts": 0,
      "detailPageViews": 0,
      "unitsSold": 0,
      "link": {
        "id": "<string>",
        "link_name": "<string>",
        "url": "<string>",
        "active": true,
        "type": "product",
        "marketplace": "<string>"
      }
    }
  ],
  "next_cursor": "<string>"
}

Reports

Sales, commission and traffic for your links

See how your Archer links are performing — sales, commission, clicks and conversions — broken down by day, product and Amazon marketplace.

How rows are organised

You get one row for every combination of day, product and marketplace one of your links drove activity for. Each row carries its own marketplace and currency so you can mix multiple marketplaces in a single request.

Date range

start and end are required. Either format works: 2026-05-01 or 20260501. Both ends are inclusive.

Filtering by marketplace

Pass marketplace=amazon.co.uk (or any marketplace we support) to limit results to that marketplace. Pass marketplace=all or leave it out to get every marketplace in one call.

What’s in the numbers

Sales, conversions, units sold, add-to-carts and detail page views include both the linked product itself and any other items from the same brand the shopper bought after clicking — that’s how Amazon’s affiliate program credits publishers. The numbers are returned in the marketplace’s native currency. No currency conversion is applied; the row’s currency field tells you which one it is.

Paging through results

Use limit to control page size (1–500, default 100). For the next page, take next_cursor from the response and pass it back as cursor. When next_cursor comes back null, you’ve seen everything.

GET

reports

Sales, commission and traffic for your links

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

{
  "total_count": 123,
  "fetched_count": 123,
  "rows": [
    {
      "asin": "<string>",
      "date": "<string>",
      "marketplace": "<string>",
      "country_code": "<string>",
      "currency": "<string>",
      "commissionEarned": 0,
      "sales": 0,
      "conversions": 0,
      "clicks": 0,
      "addToCarts": 0,
      "detailPageViews": 0,
      "unitsSold": 0,
      "link": {
        "id": "<string>",
        "link_name": "<string>",
        "url": "<string>",
        "active": true,
        "type": "product",
        "marketplace": "<string>"
      }
    }
  ],
  "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 in one response.

asins

string | null

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

link_ids

string | null

Limit results to specific links by their Archer link id. Separate multiple ids with commas.

brand_ids

string | null

Limit results to one or more brands. Separate multiple ids 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 /reports.

total_count

integer

required

Total rows matching your filters across every page.

fetched_count

integer

required

Rows in this page.

rows

ReportRow · 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.

Get Reporting Insights

⌘I

Documentation Index

Authorizations

Query Parameters

Response