GET /api/v1/clicks — the raw click stream for your workspace, newest first, cursor-paginated.
Scope: secret key (lk_).
Query parameters
integer
default:"100"
Maximum clicks to return (max 500).
string (ISO 8601)
Cursor — return clicks strictly older than this timestamp. Pass the previous response’s
next_cursor.string (ISO 8601)
Only clicks at or after this timestamp. A lower bound for the whole walk — keep it on every page
while
before moves backwards.string (uuid)
Restrict to a single link.
string
Comma-separated link UUIDs (max 500) — clicks on any of them. Combined with
link_id, a click on
any listed link matches. A malformed id, or more than 500, is a 400.string
Set
bots=include to include bot traffic. By default bots are excluded.Response
array
Each click:
id, ts, link_id, visitor_id, channel, country, city, device,
browser, os, referer, is_bot.string | null
Pass back as
before to fetch the next page. null means the end of the stream.New clicks on your links since the last poll