Fictura
Links API
POST/v1/links

Create links

Mint tracking links programmatically — one at a time, or five hundred in a transaction.

The Links API lives at /v1 and authenticates with a Links API key — Authorization: Bearer fk_live_…, minted on Dashboard → Links → API and shown exactly once. It's a separate surface from /api/v1; the gk_ key doesn't work here.

cURL
curl -X POST https://api.fictura.co/v1/links \
  -H "Authorization: Bearer fk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Spring drop", "destination_url": "https://apps.apple.com/app/id123", "slug": "springdrop"}'
201 — created
{
  "ok": true,
  "link": {
    "id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
    "slug": "springdrop",
    "name": "Spring drop",
    "url": "https://api.fictura.co/l/springdrop",
    "destination_url": "https://apps.apple.com/app/id123",
    "link_type": "direct",
    "provider": null,
    "campaign_id": null,
    "adset_id": null,
    "ad_id": null,
    "channel": null,
    "keywords": null,
    "site_id": null,
    "is_retargeting": false,
    "deep_link_value": null,
    "click_lookback_days": 7,
    "view_lookback_hours": 24,
    "play_store_url": null,
    "desktop_url": null,
    "click_count": 0,
    "impression_count": 0,
    "created_at": "2026-10-01T09:14:03.120Z"
  }
}

name (1–120 characters) and destination_url (a URL, up to 1,000 characters) are the two required fields. slug is optional (one is generated) and must be 3–50 alphanumeric characters — no hyphens; a taken slug answers 409 slug_taken, a malformed body 400 invalid_body with an issues list. In the response, url is the short redirect (/l/<slug>) — the thing you put on the poster — and destination_url is where it points.

Optional fields

FieldLimits
providerUp to 40 characters: lowercase letters, digits, _ . -.
campaign_id, adset_idUp to 200 characters.
ad_id, keywords, sub1 to sub5Up to 100 characters.
channelUp to 20 characters.
site_idUp to 24 characters.
is_retargetingBoolean. Defaults to false.
deep_link_valueUp to 200 characters.
click_lookback_days1 to 30. Defaults to 7.
view_lookback_hours1 to 24. Defaults to 24.
play_store_url, og_image_urlA URL, up to 1,000 characters.
desktop_urlA URL, up to 1,000 characters. Where a tap from a computer goes. Leave it out to send computers to your website from App identity when destination_url is a store page.
og_titleUp to 40 characters.
og_descriptionUp to 300 characters.

The response does not echo sub1 to sub5 or the og_* fields. It adds click_count and impression_count.

Bulk

cURL
curl -X POST https://api.fictura.co/v1/links/bulk \
  -H "Authorization: Bearer fk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"links": [
    {"name": "Creator A", "destination_url": "https://apps.apple.com/app/id123"},
    {"name": "Creator B", "destination_url": "https://apps.apple.com/app/id123"}
  ]}'

POST /v1/links/bulk takes 1–500 links and runs as one transaction — all created or none, answering 201 {"ok": true, "created": n, "links": […]}. One taken slug fails them all with 409 slug_taken. Beyond 500 is a 400 invalid_body, so split the batch.

On this page