Links
Get a tracked link with its stats
const url = 'https://app.whatsetter.com/api/v1/links/example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://app.whatsetter.com/api/v1/links/example \ --header 'Authorization: Bearer <token>'One link plus stats_30d, the numbers of the dashboard drawer:
clicks and by_channel over the last 30 days (platform read on each
click; direct = no platform signature), leads and qualified =
every conversation the link brought, all time. Requires scope
links:read.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”The link and its stats
object
object
The public short link, https://app.whatsetter.com/l/<slug>.
The campaign slug the link routes to.
auto = the platform is read on each click (default); otherwise a forced platform (instagram, tiktok, …).
Click counter
object
Clicks in the last 30 days.
Clicks in the last 30 days per platform read on the click (direct = no signature).
object
Conversations the link brought
Of those
Example
{ "data": { "id": "68d9aa11bb22cc33dd44ee55", "slug": "insta-bio", "name": "Instagram bio", "url": "https://app.whatsetter.com/l/insta-bio", "campaign_id": "auto24-maroc-4-bu76", "status": "active", "channel": "auto", "clicks": 128, "last_click_at": "2026-09-18T10:00:00.000Z", "created_at": "2026-09-01T08:00:00.000Z", "stats_30d": { "clicks": 128, "by_channel": { "instagram": 90, "tiktok": 30, "direct": 8 }, "leads": 41, "qualified": 12 } }}Missing, unknown or revoked API key
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}Resource not found in this workspace
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}