Build on Linktain.

Make a key in Settings, paste it into this, and you have a live locked link in one request. Everything else on this page is detail.

curl -X POST https://linktain.com/api/v1/links \
  -H "Authorization: Bearer lt_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"title":"My download","destinationUrl":"https://example.com/file"}'

The shortUrl that comes back is the thing you share. It starts counting the moment somebody opens it.

One header on every request. Keys begin with lt_ and are made in Dashboard, Settings.

Authorization: Bearer lt_your_api_key_here

Every amount in this API is an integer number of mills. A mill is a thousandth of a dollar, so 1000 mills is $1.00 and 6420 mills is $6.42.

Integers, because money in a float is money that eventually does not add up. Divide by 1000 at the moment you print it and never before.

const usd = (mills) => (mills / 1000).toFixed(2);

usd(6420);  // "6.42"

Recent days can still move. A partner reversing a conversion takes it back off the balance it landed on, sometimes weeks later, so treat the last few days as provisional rather than final.

Wrap any URL in a gate and get a short link back.

The link is live the moment this returns. Share the shortUrl and it starts counting views.

Choose accessMode for tasks only, tasks with optional Premium, or Premium only. Omit it to keep the default: tasks with optional Premium. You can change each link in the dashboard.

curl -X POST https://linktain.com/api/v1/links \
  -H "Authorization: Bearer lt_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"title":"My download","destinationUrl":"https://example.com/file"}'

{
  "id": "cmd7x1abc0001xyz",
  "slug": "x7k2m9a",
  "shortUrl": "https://linktain.com/l/x7k2m9a",
  "title": "My download",
  "destinationUrl": "https://example.com/file",
  "accessMode": "tasks_or_premium",
  "premiumOnly": false,
  "createdAt": "2026-07-27T12:00:00.000Z"
}

Every link on your account, newest first, with its lifetime totals.

Returns all your links in one response. Pagination is not currently supported.

curl https://linktain.com/api/v1/links \
  -H "Authorization: Bearer lt_your_api_key_here"

{
  "links": [
    {
      "id": "cmd7x1abc0001xyz",
      "slug": "x7k2m9a",
      "shortUrl": "https://linktain.com/l/x7k2m9a",
      "title": "My download",
      "destinationUrl": "https://example.com/file",
      "active": true,
      "views": 1523,
      "unlocks": 1284,
      "earnedMills": 7420,
      "createdAt": "2026-07-27T12:00:00.000Z"
    }
  ]
}

Lifetime totals, the earnings split, and a day by day series.

Ask for a link that is not yours and you get a 404, the same answer as a link that does not exist. We do not confirm that somebody else's id is real.

unlocks counts recorded task unlocks, including repeat visits. The legacy paidUnlocks field counts unlocks eligible for a per-unlock credit after the 24-hour visitor deduplication. A counted unlock can earn zero; use earnedMills for revenue.

curl https://linktain.com/api/v1/links/cmd7x1abc0001xyz/stats \
  -H "Authorization: Bearer lt_your_api_key_here"

{
  "views": 1523,
  "unlocks": 1284,
  "paidUnlocks": 1180,
  "conversions": 47,
  "unlockMills": 1180,
  "offerMills": 5240,
  "passMills": 1000,
  "earnedMills": 7420,
  "last14d": [
    { "date": "2026-07-14", "views": 96, "unlocks": 80 },
    { "date": "2026-07-15", "views": 112, "unlocks": 95 }
  ]
}

One tag on a site you own turns every outbound link on it into a locker. You do not rewrite any hrefs and you do not create the links: the first time somebody clicks one we make it, and every click after that uses the same one.

<script src="https://linktain.com/e.js" data-key="pk_your_site_key"></script>

Register the site in Dashboard, Links to get the key. It is public on purpose, because it sits in your page source where anybody can read it. What stops somebody else using it is the hostname you registered against it: a request from any other site is refused.

<a href="https://example.com/sponsor" data-linktain="off">never locked</a>

<script src="https://linktain.com/e.js"
        data-key="pk_your_site_key"
        data-selector="a.paid"></script>

Every failure is the same shape, { "error": "..." }, with the status carrying the category and the string saying what to fix.

400

The body was not JSON, or a field failed validation.

The message names the field, e.g. "destinationUrl: must use http:// or https://". Fix it and send again.

401

No Authorization header, or the key is wrong, or you revoked it.

Check the header reads Bearer lt_… and that the key is still listed in Settings.

403

The account cannot use the API: awaiting approval, suspended, or banned.

The message says which. Approval is the usual one and it is a person, not a queue you can retry past.

404

No link with that id on your account.

Check the id came from your own list. Somebody else's id answers 404 too.

500

We broke.

Retry once. If it keeps happening, tell us on Telegram and include roughly when.

503

Could not allocate a short code, which takes an unlucky run of collisions.

Retry. It is transient and it clears immediately.