An API for every object in your program

Everything you can do in the dashboard, you can do over HTTPS with JSON. We store every amount as an integer in minor units with its ISO currency code, so nothing rounds by accident.

  • JSON over HTTPS
  • X-API-KEY header
  • No duplicate orders
  • Signed webhooks
Sample request and response
curl https://api.trackspot.ai/v1/conversions \
  -H "X-API-KEY: $TRACKSPOT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "5f0c2a9e-4b1d-4c3e-9a77-2d1e8b6f4a10",
    "order_id": "A-1001",
    "amount": "96.00",
    "currency": "USD",
    "type": "sale"
  }'
201 Created
{
  "data": {
    "id": "0b7e3c51-9d2a-4f60-8e14-6a3f9c2d7b85",
    "status": "pending",
    "sale_amount": 9600,
    "payout": 2880,
    "currency": "USD"
  }
}

You call us, we call you

Send data with REST requests. Get each change back as a webhook, so your systems do not have to poll.

Requests you send

Base URL https://api.trackspot.ai/v1

  • POST /v1/conversionsRecord a sale, lead or renewal
  • POST /v1/clicksRecord a click from your own redirect
  • GET /v1/conversionsFilter by status, partner, date or order ID
  • POST /v1/conversions/bulk-statusApprove or decline up to 1,000 at once
  • GET /v1/affiliates/:id/balanceApproved, pending, in-payout and paid balance

Events we send

A JSON POST to the URL you choose, for the events you pick.

  • conversion.createdA new conversion is recorded
  • conversion.status_changedA conversion is approved, declined or reversed
  • affiliate.createdA new partner signs up
  • payout.createdA payout is created
  • payout.status_changedA payout changes status, for example to paid

What the API covers

  • Partners

    Create, approve and update partners. Read balances and payout details.

  • Offers and links

    Manage offers, landing pages and tracking links.

  • Clicks

    Record a click from your own redirect and get back a click ID to store.

  • Conversions

    Send sales, leads and renewals with an amount, currency and order ID.

  • Commissions

    List commissions and add bonus or adjustment commissions.

  • Payouts

    Create payout batches, export them and mark them paid.

  • Reports

    Query any report the dashboard shows, with the same dimensions and filters.

  • Webhooks

    Subscribe to events such as conversion.created or payout.status_changed.

Built for scripts that run on their own

These rules stop an unattended job from counting a sale twice or rounding an amount.

  • One header for auth

    Send your key in the X-API-KEY header. Each key has an admin or manager role. Read-only keys are planned.

  • Safe to retry

    Send an order ID with each conversion. A second request with the same order ID gets a 409 duplicate_order_id error and creates no duplicate.

  • Exact money

    Send amounts as decimal strings in your account currency. Responses carry amounts as integers in minor units (9600 = 96.00). Webhooks carry both forms.

  • Signed webhooks

    Each webhook carries a signature made with your webhook secret. Failed deliveries retry on their own.

Rate limit: 20 requests a second on every plan

Program plans
Spark 20/s, Orbit 20/s, Summit 20/s
Network plans
Hub 20/s, Relay 20/s, Exchange 20/s
iGaming plans
Solo 20/s, Group 20/s

Get started

  1. Create a key

    Go to Integrations → API keys, create a key and choose its role.

  2. Check the key

    Call GET /v1/affiliates and look for a 200 response.

  3. Send a test sale

    Send a conversion with a click ID from a test link and watch it appear in Reports → Conversions.

Questions about the API

How do we authenticate?

Send your key in the X-API-KEY header on every request. Each key has an admin or manager role. Read-only keys are planned.

What are the rate limits?

20 requests per second per account, on every plan. Above that you get a 429 response with a Retry-After header that says when to try again.

Are requests idempotent?

Conversion requests accept an order ID. If you send the same order ID twice, the second request gets a 409 duplicate_order_id error, so no duplicate is created.

Get an API key in a trial account

Start a 21-day trial with every feature on. No card needed. Or book a call and we set it up with you.