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 an affiliate account: get a token, browse the catalog, create an attribution link, and pull a report. Substitute your own credentials and ASIN as you go.

​
1. Get a token

curl -X POST https://api.archeraffiliates.com/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. Find a product

Browse the catalog, scoped to a specific Amazon marketplace: 
curl "https://api.archeraffiliates.com/getproducts?marketplace=amazon.com&limit=5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Each row in product_catalog includes the asin and which marketplace it belongs to.
Pass marketplace=all to span every marketplace. Each product still carries its own marketplace field so you can group client-side.
Pick an ASIN from the previous step and call POST /generate_attribution_link: 
curl -X POST https://api.archeraffiliates.com/generate_attribution_link \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "asin": "B0D45KS7QM",
    "link_name": "my-first-link",
    "marketplace": "amazon.com"
  }'
Response: 
{
  "url": "https://www.amazon.com/dp/B0D45KS7QM?...",
  "attribution_link": "https://www.amazon.com/dp/B0D45KS7QM?...",
  "id": "65f...",
  "asin": "B0D45KS7QM",
  "marketplace": "amazon.com",
  "type": "product",
  "active": true
}
Use url anywhere a shopper will click it. 
curl "https://api.archeraffiliates.com/get_all_links?limit=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
You’ll see the link you just made along with every other link your account has created.

​
5. Pull a report

Once your link has had some traffic, see how it’s doing: 
curl "https://api.archeraffiliates.com/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 — with clicks, sales, units sold, and your commission.

​
Going further

  • Bulk link generation — submit up to 5,000 ASINs in a single POST /bulk_generate_attribution_links call and we’ll email you a CSV when it’s done. See Attribution links.
  • Marketplaces — read Marketplaces for the rules on amazon.com vs amazon.co.uk vs all.
  • Brands — read Brands and products for how to filter the catalog by brand.