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.

An attribution link is an Amazon URL Archer creates for you that carries a few attribution tags. When a shopper clicks it and buys, the sale gets attributed back to:
  1. You (the publisher) — so you get your share of the commission.
  2. The brand — so they know which creator drove the sale.
Each link points at exactly one ASIN on exactly one marketplace. Use POST /generate_attribution_link when you’re creating one link at a time: 
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": "spring-2026-yt-campaign",
    "marketplace": "amazon.com"
  }'
Response is synchronous — you get the attribution URL back immediately.

​
Picking a marketplace

marketplace controls which Amazon marketplace the link points to. Defaults to amazon.com. See Marketplaces for the full list. link_name is just for your own bookkeeping — it shows up in reports and listings so you can tell links apart later. Common patterns: campaign name, video title, channel + date.

​
Bulk generation

Use POST /bulk_generate_attribution_links when you need to create a lot of links at once: 
curl -X POST https://api.archeraffiliates.com/bulk_generate_attribution_links \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "links": [
      {"asin": "B0D45KS7QM", "link_name": "video-001", "marketplace": "amazon.com"},
      {"asin": "B07XJ8C8F5", "link_name": "video-002", "marketplace": "amazon.co.uk"}
    ]
  }'
The endpoint returns 202 Accepted immediately with a job_id. Generation happens in the background and we email you a CSV when it’s done — no need to poll. Up to 5,000 ASINs per request. The CSV has one row per submitted ASIN:
ColumnWhat it is
ASINThe product identifier you submitted.
MarketplaceThe marketplace you asked for.
Link NameYour label for the link.
Attribution URLThe generated URL — blank if the row failed.
Statusok if it worked, error otherwise.
ErrorExplanation for failed rows.
Individual ASIN failures don’t fail the whole job — you get one CSV with the good rows and the bad rows side by side. Use GET /get_all_links to page through links you’ve created. Filter by marketplace with marketplace=… (defaults to amazon.com; pass all to span every marketplace). The most common failure modes:
  • ASIN not found — the product isn’t in the catalog for the chosen marketplace. Double-check the ASIN and marketplace.
  • Brand not granting access — you’re not currently approved to promote that brand. Reach out to the brand or to Archer support.
  • Amazon attribution service unavailable — transient. Retry in a few seconds for single-link calls, or resubmit the failed CSV rows for bulk.