Generate attribution links in bulk

curl --request POST \
  --url https://api.example.com/bulk_generate_attribution_links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "links": [
    {
      "asin": "<string>",
      "link_name": "<string>",
      "marketplace": "amazon.com"
    }
  ],
  "email": "you@example.com"
}
'

{
  "job_id": "<string>",
  "queued_count": 123,
  "email": "<string>",
  "status": "queued"
}

Attribution Links

Generate attribution links in bulk

Kick off a bulk attribution-link generation job. Submit up to 5,000 ASINs in a single request and we’ll email you a CSV of the finished links once they’re ready — no need to poll.

What goes in

Pass a links array, one entry per ASIN. Each entry takes the same fields as /generate_attribution_link:

asin — the Amazon product identifier.
link_name — your label for the link (shows up in reports).
marketplace — which Amazon marketplace the link should point at. Defaults to amazon.com.

Optionally pass email to override where the CSV is delivered; otherwise we use the email on your account.

What you get

The endpoint returns immediately with a job_id and a queued status — the actual generation happens in the background. When the job finishes, you’ll receive an email with a CSV attachment. Each row in the CSV carries the ASIN, marketplace, link name, the generated attribution URL, and a status column flagging any rows that couldn’t be generated (e.g. unknown ASIN, brand not granting access).

Limits and errors

Up to 5,000 ASINs per request. Submit multiple jobs for larger runs.
Individual ASIN failures are reported in the CSV — they don’t fail the whole job.
Invalid marketplace values are rejected up-front with a 400.

POST

bulk_generate_attribution_links

Generate attribution links in bulk

curl --request POST \
  --url https://api.example.com/bulk_generate_attribution_links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "links": [
    {
      "asin": "<string>",
      "link_name": "<string>",
      "marketplace": "amazon.com"
    }
  ],
  "email": "you@example.com"
}
'

{
  "job_id": "<string>",
  "queued_count": 123,
  "email": "<string>",
  "status": "queued"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Inputs for kicking off a bulk attribution-link generation job.

links

BulkAttributionLinkItem · object[]

required

The ASINs to generate attribution links for. Up to 5,000 per request.

Required array length: 1 - 5000 elements

Show child attributes

string | null

Where to send the finished CSV. Defaults to the email on your account when omitted.

Example:

"you@example.com"

Response

Successful Response

The receipt you get back after queueing a bulk link job.

job_id

string

required

Identifier you can reference in support — included in the CSV email.

queued_count

integer

required

How many ASINs were accepted for processing.

string

required

Where the CSV will be delivered when the job finishes.

status

string

default:queued

Always queued for a fresh request.

Create an attribution Amazon link List the attribution links you've created

⌘I

Documentation Index

Authorizations

Body

Response