Sales and commission for your brand's products

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.archeraffiliates.com/sellers/reports', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.archeraffiliates.com/sellers/reports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.archeraffiliates.com/sellers/reports"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.archeraffiliates.com/sellers/reports")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

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.

What you’ll see

You get one row for every combination of day, product and marketplace. Each row tells you what activity 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.

What’s in the numbers

Sales, conversions, 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.

Clicks are link-level — don’t sum them

Amazon reports clicks per ad group, per day, not per product — and every Archer link is backed by exactly one ad group. Rows here are per-product, so the same daily click total repeats across every product row driven by that link, and summing the clicks column double-counts.

This endpoint does not expose a link identifier, so the column cannot be deduplicated from the response. Read clicks as an indicator of traffic on the row’s link, not as a summable total. For brand-wide click totals, use the dashboard or the affiliate GET /reports surface, which carries link.id.

See the Reporting concept for details.

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.archeraffiliates.com/sellers/reports \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.archeraffiliates.com/sellers/reports', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.archeraffiliates.com/sellers/reports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.archeraffiliates.com/sellers/reports"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.archeraffiliates.com/sellers/reports")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

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.

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

total_count_exact

boolean

default:true

True when total_count is exact. False means MongoDB hit the bounded count time limit; use next_cursor to continue paging.

next_cursor

string | null

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

Auth

Reports

Brands

Products

Sales and commission for your brand's products

What you’ll see

Filtering

What’s in the numbers

Clicks are link-level — don’t sum them

Paging through results

Authorizations

Query Parameters

Response