GET Get viewer visitor statistics
Retrieve visitor statistics for multiple viewers with support for detailed session information or aggregated views per day Required scopes: viewer.stats:read
Are you an LLM? You can read better optimized documentation at /docs/api/endpoints/statistics/get-viewers-statistics.md for this page in Markdown format
GET
Try it out https://api.rooom.com/viewers/statisticsScopes
viewer.stats:readParameters
Query Parameters
| Name | Type | Description | Values |
|---|---|---|---|
viewerTokenListExample: abc123,def456,ghi789 | string | Comma-separated list of viewer tokens (if empty, queries all owned viewers) | |
modeExample: visitor-tracking | string | Statistics mode: 'visitor-tracking' for detailed session information (default) or 'views' for daily visit counts | visitor-trackingviews |
backToExample: 30 days | string | Time scope for data retrieval (e.g. '3 days', '2 months', '1 year') |
Responses
200Successfully retrieved viewer statistics
401Authentication required - Invalid or missing token
403Insufficient permissions - Required scope missing
422Validation failed - Invalid mode parameter
500Internal server error
GET /viewers/statistics Get viewer visitor statistics Retrieve visitor statistics for multiple viewers with support for detailed session information or aggregated views per day Required scopes: viewer.stats:read viewerTokenList Comma-separated list of viewer tokens (if empty, queries all owned viewers) mode Statistics mode: 'visitor-tracking' for detailed session information (default) or 'views' for daily visit counts backTo Time scope for data retrieval (e.g. '3 days', '2 months', '1 year')