List sessions
rybbit_list_sessionsRetrieve paginated visitor sessions with detailed analytics: location, browser, device, referrer, entry/exit pages, pageview and event counts, duration, and UTM parameters. Filter by date range, user, or custom conditions.
Instructions
Get a paginated list of visitor sessions with details: location, browser/OS/device, referrer, entry/exit pages, pageview and event counts, duration, and UTM params.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | Yes | The Rybbit site ID (numeric ID from your Rybbit dashboard or the rybbit_list_sites tool). | |
| page | No | Page number, 1-indexed. | |
| limit | No | Number of sessions per page. | |
| user_id | No | Filter to sessions for a specific Rybbit user_id. | |
| identified_only | No | Set to restrict to sessions with an identified user (per Rybbit's identify() API). | |
| start_date | No | Start date, e.g. 2024-01-01. Use with end_date and time_zone. | |
| end_date | No | End date, e.g. 2024-01-31. Use with start_date and time_zone. | |
| time_zone | No | IANA time zone, e.g. America/New_York. Required when using start_date/end_date or start_datetime/end_datetime. | |
| start_datetime | No | Exact start datetime, e.g. '2024-01-15 13:00:00' (UTC). Alternative to start_date. | |
| end_datetime | No | Exact end datetime, e.g. '2024-01-15 15:00:00' (UTC). Alternative to end_date. | |
| past_minutes_start | No | Relative range start in minutes ago, e.g. 60. Use with past_minutes_end instead of dates. | |
| past_minutes_end | No | Relative range end in minutes ago, e.g. 0 for 'now'. Use with past_minutes_start. | |
| filters | No | Optional list of filters to narrow the data (AND logic across different filters). Example: [{"parameter":"country","type":"equals","value":["US"]}] |