LinkDrop API

Manage your links and page, pull views, clicks, campaigns and revenue into a spreadsheet, Airtable base or automation tool, and get every click pushed to you as a webhook. Plain JSON over HTTPS.

Authentication

Send the key as a Bearer token on every request. x-api-key works too. Up to 10 named keys per account; a read-only key gets 403 on anything but GET.

curl https://linkdrop.uk/api/v1/me \
  -H "Authorization: Bearer ld_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Pages

Every request acts on your main page by default. If you have extra link pages, pass ?page=<page id> on any endpoint to act on that page instead. Page ids come from GET /me.

GET /api/v1/links?page=9f2c1a4e-…

Errors & limits

Errors return a JSON body with an error message.

Links are saved with the same validation as the dashboard: url must be http(s)://, title ≤ 120 chars, subtitle ≤ 200 chars, at most 100 links per page.

Endpoints

Your account and every page the key can reach.

{
  "id": "5c0e…", "username": "ella", "name": "Ella", "planTier": "business",
  "pages": [
    { "id": "5c0e…", "username": "ella",    "name": "Ella",  "url": "https://linkdrop.uk/@ella", "main": true,  "tags": [] },
    { "id": "9f2c…", "username": "ella-vip","name": "VIP",   "url": "https://links.ella.com",   "main": false, "tags": ["vip"] }
  ]
}

All links on the page, in display order. position is the zero-based index.

{
  "page": { "id": "5c0e…", "username": "ella", "url": "https://linkdrop.uk/@ella", "main": true, "tags": [] },
  "links": [
    { "id": "lm3k9x2a1b", "position": 0, "title": "My Fanvue", "publicTitle": null, "subtitle": "50% off today",
      "url": "https://www.fanvue.com/ella", "active": true, "kind": null, "imageUrl": null, "accentColor": null,
      "restricted": true }
  ]
}

restricted is true for adult-platform links - those get LinkDrop's protection layer automatically. kind: "post" marks a post-style tile.

One link. Returns { "link": { … } } with the same shape as above.

Add a link. Returns 201 with the created link.

curl -X POST https://linkdrop.uk/api/v1/links \
  -H "Authorization: Bearer ld_live_…" -H "Content-Type: application/json" \
  -d '{ "title": "New drop 🔥", "url": "https://www.fanvue.com/ella", "subtitle": "Only this week", "position": "top" }'

Change any of the fields above. Send only what changes; null clears a field. position moves the link.

curl -X PATCH https://linkdrop.uk/api/v1/links/lm3k9x2a1b \
  -H "Authorization: Bearer ld_live_…" -H "Content-Type: application/json" \
  -d '{ "active": false, "subtitle": null }'

Removes the link. Returns { "ok": true, "id": "…" }. Its past clicks stay in your analytics.

Create up to 100 links in one call. Body: { "links": [ {…}, {…} ], "position": "top" } - each item takes the same fields as POST /links. Returns 201 with { "links": [ … ] } in the order they were inserted. Nothing is saved if any item is invalid.

Replace the whole list - the spreadsheet is the source of truth. Items with an existing id are updated and keep their stats; items without one are created; links missing from the array are deleted. The array order becomes the page order.

curl -X PUT https://linkdrop.uk/api/v1/links \
  -H "Authorization: Bearer ld_live_…" -H "Content-Type: application/json" \
  -d '{ "links": [
        { "id": "lm3k9x2a1b", "title": "My Fanvue", "active": true },
        { "title": "New: custom video", "url": "https://www.fanvue.com/ella/shop" }
      ] }'

Response: { "links": [ … ], "removed": [ "id", … ] }.

{ "ids": [ "…", "…" ] } - reorders without touching content. Ids you leave out keep their relative order after the ones you listed.

Extra link fields

Every field is writable through POST, PATCH, PUT and the batch call; null clears it.

The page itself: name, bio, accentColor, avatarUrl, avatarPos, banner, followers, verified, socials, linkCount, directLink, hasPassword, security, design, plus the summary fields from /me.

Send only what changes. Everything the dashboard's Profile and Security tabs can set is here.

curl -X PATCH https://linkdrop.uk/api/v1/page \
  -H "Authorization: Bearer ld_live_…" -H "Content-Type: application/json" \
  -d '{ "username": "ella-vip", "tags": ["vip"], "security": { "vpnShield": "strict", "geo": { "mode": "block", "countries": ["IN"] } } }'

The page's look: template, layout, background, fonts, button shape and colours, avatar, socials row, section order, message box and countdown. The response carries options - every enum, numeric range and colour key the server accepts - so a tool can build a form from it.

{
  "design": { "template": "noir", "layout": "auto", "bgStyle": "gradient", "bgColor": "#0b0b12", "bgColor2": "#3b1d6e",
              "fontStyle": "rounded", "buttonShape": "pill", "buttonFill": "glass", "buttonAnim": "none",
              "order": ["socials", "followers", "bio", "links", "posts", "msg"],
              "msgBox": { "enabled": true, "url": "https://…", "placeholder": "Say hi" },
              "countdown": { "enabled": true, "text": "Offer ends in", "minutes": 60 }, … },
  "options": { "enums": { "bgStyle": ["blur","solid","gradient"], … }, "ranges": { "fontScale": [80,140], … },
               "colors": ["bgColor","bgColor2","textColor","buttonTextColor"], "sections": [ … ] }
}

Send any subset of the fields above; null resets one to its default. Validated exactly like the dashboard's Design tab (page design is Pro+; on a lower plan the values are stored but not rendered).

curl -X PATCH https://linkdrop.uk/api/v1/page/design \
  -H "Authorization: Bearer ld_live_…" -H "Content-Type: application/json" \
  -d '{ "buttonShape": "pill", "buttonFill": "solid", "bgStyle": "solid", "bgColor": "#111111", "countdown": { "enabled": true, "text": "Sale ends in", "minutes": 120 } }'

{ "password": "secret" } puts the whole page behind a password (4-100 chars); { "password": null } removes it. The password itself is never returned - GET /page only reports hasPassword.

Every page the key can reach - same list as /me.

{ "username": "ella-vip", "name": "VIP", "cloneFrom": "<page id>" } creates an extra link page (Pro+, within your plan's page count). cloneFrom copies design and links from another of your pages. Returns 201 with the new page - use its id as ?page= from then on.

Deletes an extra page and its stats. The main page cannot be deleted.

Totals for the last days days (1-365, default 30), bucketed per day in the Europe/Bratislava timezone.

{
  "page": { … }, "days": 30, "since": "2026-08-22T22:00:00.000Z", "truncated": false,
  "totals": { "views": 4210, "clicks": 1388, "ctr": 33 },
  "byDay":  [ { "date": "2026-08-23", "views": 120, "clicks": 41 }, … ],
  "byLink": [ { "id": "lm3k9x2a1b", "title": "My Fanvue", "clicks": 902 }, … ],
  "bySource":  { "instagram": { "views": 3100, "clicks": 1002 }, "direct": { … } },
  "byCountry": { "US": { "views": 1800, "clicks": 610 }, "GB": { … } },
  "byCampaign": { "story-sep20": { "views": 410, "clicks": 190 } },
  "byDevice":  { "mobile": 3900, "tablet": 40, "desktop": 270, "unknown": 0 }
}

Add &campaign=<code> to get the same report for one campaign only.

Campaign links need no setup: share your page as https://linkdrop.uk/@ella?c=story-sep20 (or your custom domain) and every view and click from that link carries the code. Codes are lower-case letters, digits, - and _, up to 32 chars. Put a different code in every post, story or ad and this endpoint tells you which one worked.

{
  "howTo": "https://linkdrop.uk/@ella?c=",
  "campaigns": [
    { "code": "story-sep20", "url": "https://linkdrop.uk/@ella?c=story-sep20",
      "views": 410, "clicks": 190, "ctr": 46.3,
      "byLink": [ { "id": "lm3k9x2a1b", "title": "My Fanvue", "clicks": 150 } ],
      "firstSeen": "2026-09-20T08:01:11Z", "lastSeen": "2026-09-20T21:40:02Z" }
  ]
}

{
  "estimated": true, "connected": true, "days": 30, "coverageDays": 27,
  "totalRevenue": 4180.5, "attributedRevenue": 3120.0, "unattributedRevenue": 1060.5,
  "links": [ { "id": "lm3k9x2a1b", "title": "My Fanvue", "url": "https://www.fanvue.com/ella",
               "clicks": 902, "revenue": 2410.2, "revenuePerClick": 2.67 } ]
}

{
  "events": [
    { "id": 8812031, "type": "click", "linkId": "lm3k9x2a1b", "linkTitle": "My Fanvue",
      "source": "instagram", "country": "US", "device": "mobile", "campaign": "story-sep20", "at": "2026-09-20T09:14:02.331Z" }
  ],
  "nextCursor": "8812031"
}

POST https://your-endpoint.example/linkdrop
Content-Type: application/json
X-LinkDrop-Event: click
X-LinkDrop-Delivery: 2f6c…            (unique per delivery - use it to dedupe)
X-LinkDrop-Signature: t=1758360000,v1=9a3f…

{ "id": "2f6c…", "type": "click", "createdAt": "2026-09-20T09:14:02.331Z", "pageId": "5c0e…",
  "data": { "type": "click", "linkId": "lm3k9x2a1b", "source": "instagram", "country": "US", "device": "mobile", "campaign": "story-sep20" } }

const crypto = require('crypto');
function verify(rawBody, header, secret) {
  const t = header.match(/t=(\d+)/)[1], v1 = header.match(/v1=([a-f0-9]+)/)[1];
  const expected = crypto.createHmac('sha256', secret).update(t + '.' + rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected)) && Date.now() / 1000 - t < 300;
}

curl -X POST https://linkdrop.uk/api/v1/webhooks \
  -H "Authorization: Bearer ld_live_…" -H "Content-Type: application/json" \
  -d '{ "url": "https://hook.eu1.make.com/abc123", "events": ["click", "link.updated"] }'

{ "webhook": { "id": "…", "url": "…", "events": ["click","link.updated"], "active": true, "secret": "whsec_…" } }

const KEY = 'ld_live_…';
const { recordId } = input.config();
const table = base.getTable('Links');
const rec = await table.selectRecordAsync(recordId);

const r = await fetch('https://linkdrop.uk/api/v1/links', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ' + KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    title: rec.getCellValueAsString('Title'),
    url: rec.getCellValueAsString('URL'),
    subtitle: rec.getCellValueAsString('Subtitle') || undefined,
    active: !!rec.getCellValue('Active'),
  }),
});
const data = await r.json();
if (!r.ok) throw new Error(data.error);
await table.updateRecordAsync(recordId, { 'LinkDrop ID': data.link.id });