Your partnerships. Your integration.

Fetch advertisers

Read advertiser profiles and markets. Publishers can retrieve links for their own channel with an approved partnership.

Permission advertisers:read

Parameters

In the URL query string

curl --get "https://adtrade.io/api/v1/advertisers?market=SE&page=1&per_page=50" \
  --header "Authorization: Bearer $ADTRADE_API_KEY" \
  --header "Accept: application/json"

{
    "rows": [
        {
            "id": 4,
            "advertiser_code": "100",
            "name": "Example Store",
            "status": "active",
            "approval_status": "approved",
            "website_url": "https://shop.example.com",
            "tracking_url": null,
            "links": []
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 50
}

The response contains rows, total, page and per_page. Check status and approval_status; the list can include inactive or unapproved advertisers. channel_code requires a publisher key and an owned channel. Use the public code, not the internal channel_id.

Use tracking_url when tracking_available is true in links. Otherwise url may be an ordinary store address without attribution. Each market has its own link. A single market can also populate tracking_url on the advertiser row.

Fetch campaigns

Retrieve current offers and discount codes, with tracking links for eligible publisher channels.

Permission campaigns:read

Parameters

In the URL query string

curl --get "https://adtrade.io/api/v1/campaigns?market=SE&page=1&per_page=50" \
  --header "Authorization: Bearer $ADTRADE_API_KEY" \
  --header "Accept: application/json"

{
    "rows": [
        {
            "id": "12",
            "advertiser_id": "4",
            "advertiser_name": "Example Store",
            "description": "10% discount",
            "discount_code": "EXAMPLE10",
            "markets": [
                "SE"
            ],
            "tracking_links": [
                {
                    "channel_code": "1234567",
                    "channel_name": "Example Channel",
                    "market": "SE",
                    "url": "https://adtrade.io/t?a=100&c=1234567&m=SE&campaign=12&voucher=EXAMPLE10"
                }
            ]
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 50
}

Only active campaigns within their validity period are shown; dates follow Swedish time. Exclusive campaigns depend on account access. Publisher responses include tracking_links, which can be empty. Advertiser responses do not include this field. Reuse the returned links and their campaign parameters.

Register purchases and events

Send an event from the advertiser’s server using an advertiser key. The key must belong to the advertiser specified in the request.

Permission transactions:write

Parameters

JSON request body

curl --request POST "https://adtrade.io/t" \
  --header "Authorization: Bearer $ADTRADE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "event": "Purchase", "advertiserCode": "100",
    "channelCode": "1234567", "market": "SE",
    "clickId": "CLICK_ID_FROM_LANDING_URL",
    "orderReference": "EXAMPLE-1001",
    "amount": "200.00", "currency": "SEK"
  }'

{
    "status": "accepted",
    "queued": true,
    "receiptId": "00000000-0000-4000-8000-000000000001",
    "event": "Purchase"
}

{
    "success": true,
    "eventId": 101,
    "event": "Purchase",
    "recognized": true,
    "conversion": true,
    "duplicate": false,
    "transaction": {
        "id": 1001,
        "status": "pending",
        "orderReference": "EXAMPLE-1001",
        "amount": "200.00",
        "commissionAmount": "16.00",
        "currency": "SEK"
    }
}

Purchase requires orderReference, amount and currency. The channel, market, program, attribution and commission rules determine whether a transaction is created. Other event names must match the program configuration. clickId is optional in the protocol; send the value from the landing URL to link the purchase to a registered click.

200 means processing has completed; check recognized, conversion and duplicate. 202 only confirms receipt in a durable queue. receiptId is a receipt ID, not a transaction ID or a promise of commission. There is no public lookup endpoint for this ID; check the event and transaction logs in the portal.

After an uncertain network outcome or 503, retry with the same purchase data and orderReference. The same order reference for an advertiser protects against duplicate financial transactions, but additional event records can be logged. Treat 202 as received; do not resend just because the transaction is not yet visible.

Tracking link & redirect

Send visitors to the advertiser through Adtrade. Prefer the tracking_url returned by the API or portal.

No API key · public tracking link

Parameters

In the URL query string

https://adtrade.io/t?a=100&c=1234567&m=SE&r=article-123

HTTP/1.1 302 Found
Location: https://shop.example.com/?advertiserCode=100&channelCode=1234567&market=SE&clickId=...

Opened by the visitor’s browser without an API key. A valid partnership normally returns 302 to the advertiser’s landing page with clickId and tracking information. An invalid link may display a fallback page instead. A visit is not a purchase and does not guarantee commission. Follow the program terms and consent settings.