> ## Documentation Index
> Fetch the complete documentation index at: https://doc.trackrev.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Clicks

> The raw click stream, newest first, cursor-paginated.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.trackrev.io/api/v1/clicks?limit=100" \
    -H "Authorization: Bearer <your secret key>"
  ```
</RequestExample>

`GET /api/v1/clicks` — the raw click stream for your workspace, newest first, cursor-paginated.

**Scope:** secret key (`lk_`).

## Query parameters

<ParamField query="limit" type="integer" default="100">
  Maximum clicks to return (max 500).
</ParamField>

<ParamField query="before" type="string (ISO 8601)">
  Cursor — return clicks strictly older than this timestamp. Pass the previous response's
  `next_cursor`.
</ParamField>

<ParamField query="link_id" type="string (uuid)">
  Restrict to a single link.
</ParamField>

<ParamField query="bots" type="string">
  Set `bots=include` to include bot traffic. By default bots are excluded.
</ParamField>

## Response

<ResponseField name="clicks" type="array">
  Each click: `id`, `ts`, `link_id`, `visitor_id`, `channel`, `country`, `city`, `device`,
  `browser`, `os`, `referer`, `is_bot`.
</ResponseField>

<ResponseField name="next_cursor" type="string | null">
  Pass back as `before` to fetch the next page. `null` means the end of the stream.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "clicks": [
      {
        "id": "c1a2...",
        "ts": "2026-07-21T09:14:22.000Z",
        "link_id": "l9f8...",
        "visitor_id": "v3b4...",
        "channel": "newsletter",
        "country": "US",
        "city": "Austin",
        "device": "mobile",
        "browser": "Safari",
        "os": "iOS",
        "referer": "https://news.example.com/",
        "is_bot": false
      }
    ],
    "next_cursor": "2026-07-21T09:14:22.000Z"
  }
  ```
</ResponseExample>

<Tip>
  Use `visitor_id` from a click to fetch that visitor's full
  [journey](/developers/endpoints/visitor-journey), or join the stream to your own orders table to
  build a warehouse.
</Tip>