Analytics | INBIO Docs

Per-link analytics — a daily time series plus top breakdowns by country, device, browser, and referrer. Bots are counted separately and never mixed into your click totals.

Get link analytics

GET /api/v1/links/{id}/analytics · scope analytics:read

Query param	Type	Description
`from`	date (`YYYY-MM-DD`)	Start of the window. Default: 30 days before `to`.
`to`	date (`YYYY-MM-DD`)	End of the window. Default: today.

The window is clamped to your plan’s analytics retention (30 days on Free, up to 10 years on Pro and Business), so a from earlier than your retention is silently raised to the earliest available day.

curl "https://in.bio/api/v1/links/42/analytics?from=2026-06-01&to=2026-06-30" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

const res = await fetch(
  "https://in.bio/api/v1/links/42/analytics?from=2026-06-01&to=2026-06-30",
  { headers: { Authorization: "Bearer YOUR_TOKEN" } },
);
const { data } = await res.json();

import requests

r = requests.get(
    "https://in.bio/api/v1/links/42/analytics",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    params={"from": "2026-06-01", "to": "2026-06-30"},
)
data = r.json()["data"]

Response

{
  "data": {
    "range": { "from": "2026-06-01", "to": "2026-06-30" },
    "totals": { "clicks": 1240, "uniques": 981, "botClicks": 64 },
    "series": [
      { "date": "2026-06-01", "clicks": 42, "uniques": 38 },
      { "date": "2026-06-02", "clicks": 55, "uniques": 49 }
    ],
    "countries": [
      { "value": "US", "clicks": 540 },
      { "value": "GB", "clicks": 210 }
    ],
    "devices":  [ { "value": "desktop", "clicks": 700 }, { "value": "mobile", "clicks": 540 } ],
    "browsers": [ { "value": "Chrome", "clicks": 820 } ],
    "referrers":[ { "value": "linkedin.com", "clicks": 300 } ]
  }
}

Field	Type	Description
`range`	object	The `from`/`to` actually used after clamping.
`totals.clicks`	integer	Human clicks in the window.
`totals.uniques`	integer	Unique human visitors.
`totals.botClicks`	integer	Bot/crawler clicks (excluded from `clicks`).
`series`	array	Per-day `{ date, clicks, uniques }`, ascending.
`countries`	array	Top 10 `{ value, clicks }` by ISO country code.
`devices`	array	Clicks by device type.
`browsers`	array	Clicks by browser.
`referrers`	array	Top 10 referrer hosts by clicks.