Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.archeraffiliates.com/llms.txt

Use this file to discover all available pages before exploring further.

Reports give you one row per day, per product, per Amazon marketplace. Each row tells you what activity drove that day: how many shoppers clicked, how many added to cart, how many bought, and how much commission moved. Two endpoints, same underlying data viewed from different sides:
  • GET /reports (Publisher API tab) — publisher view. Rows are scoped to links you created. Shows the commission you earned.
  • GET /sellers/reports (Seller API tab) — seller view. Rows are scoped to brands you own. Shows the commission you paid out and a creator column telling you which publisher drove each row.

Filtering

Both endpoints accept:
ParameterWhat it does
start, endRequired date range (inclusive). YYYY-MM-DD or YYYYMMDD.
marketplaceRestrict to one marketplace. Pass all or omit for every marketplace.
asinsComma-separated ASINs.
brand_idsComma-separated brand ids — only useful if you have access to more than one.
creatorsComma-separated creator identifiers (seller endpoint only).

Currency

Sale amounts come back in the marketplace’s native currency. The row carries both marketplace and currency. No FX conversion is applied — if you need a unified-currency aggregate, convert client-side.

Halo sales (seller view)

The seller report’s sales, conversions, and unitsSold include both the linked product itself and any other items from the same brand the shopper bought after clicking. This is the “brand halo” — Amazon counts brand-wide value driven by the creator’s link, not just the one product they linked to. The publisher report only sees the linked product’s own attributed sales.

Paging

Reports use a cursor:
curl "https://api.archeraffiliates.com/sellers/reports?start=2026-05-01&end=2026-05-31&limit=200" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Take next_cursor from the response and pass it back as cursor on the next call. When next_cursor is null, you’ve seen everything.