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.

This walks through the happy path for a seller account: get a token, list the brands and products you own, and pull a report. Substitute your own credentials as you go. All seller endpoints live under the /sellers/... prefix.

​
1. Get a token

curl -X POST https://api.archeraffiliates.com/sellers/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=YOUR_USERNAME&password=YOUR_PASSWORD"
Save the access_token from the response. See Authentication for the full details.

​
2. List the brands you own

curl "https://api.archeraffiliates.com/sellers/brands?limit=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Each row carries a brand_id and the display brand_name. Hold on to the brand_id values — you’ll pass them to /sellers/reports and /sellers/products.

​
3. List the ASINs in your brands

curl "https://api.archeraffiliates.com/sellers/products?limit=20&marketplace=all" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Each row carries the asin, the marketplace the product lives on, the owning brand_id / brand_name, and an active flag telling you whether the product is currently buyable.
Use marketplace=amazon.co.uk (or any other supported marketplace) to scope to one marketplace. marketplace=all returns products from every marketplace and stamps the row’s own marketplace field so you can group client-side.

​
4. Pull a report

See what your creators drove last month: 
curl "https://api.archeraffiliates.com/sellers/reports?start=2026-05-01&end=2026-05-31" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
You get one row per day, per product, per marketplace, per creator — with clicks, sales, units sold, and the commission you paid out. Filter to a specific brand or set of ASINs by passing brand_ids or asins as comma-separated values: 
curl "https://api.archeraffiliates.com/sellers/reports\
?start=2026-05-01&end=2026-05-31\
&brand_ids=65f...,65a...\
&asins=B0D45KS7QM,B07XJ8C8F5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Paginate by passing back the next_cursor from the previous response. When next_cursor is null, you’ve seen everything.

​
What’s in each report row

FieldWhat it tells you
creatorWhich Archer affiliate drove the row.
salesAttributed sales, in the marketplace’s native currency.
unitsSoldIncludes the linked product plus any other items from your brand.
commissionPaidCommission you owe the creator for this row.
brandReferralBonusAmazon Brand Referral Bonus credited to your brand.

​
Going further

  • Marketplaces — read Marketplaces for the rules on amazon.com vs amazon.co.uk vs all.
  • Brands and products — read Brands and products for the catalog model.