GET /sites/:site_id/sessions
List sessions
Closed sessions for one site, one row each, with what visitors raged and dead-clicked at.
Returns session_summary rows in a shape an LLM can read directly: the route path, entry and exit route, duration, outcome, and the top three rage-click and dead-click targets for each session.
Synthetic traffic (known bots and monitors) is excluded unless include_synthetic=true.
Query parameters
| Name | Required | Meaning |
|---|---|---|
| since | No | Relative window such as 24h or 7d. Use instead of from/to. |
| from | No | ISO-8601 start. Required with to when since is not given. |
| to | No | ISO-8601 end. |
| outcome | No | bounce, engaged or converted. |
| limit | No | 1 to 200 rows, default 50. |
| include_synthetic | No | true to include bot and monitor sessions. |
Returns
- session_id, path, entry_route, exit_route
- Where the visit went
- duration_ms, outcome, truncated
- How it ended
- rage_click_count, dead_click_count
- Frustration counts
- top_rage_click_targets, top_dead_click_targets
- Up to 3 labels with counts
- release_id, rule_version, started_at, ended_at
- Provenance