API reference

Analytics

Aggregate usage and performance across your brand's streams.

GET /api/v1/analytics — scope: analytics:read

Param	Default	Notes
`period`	`7d`	`24h`, `7d`, or `30d`.
`stream_id`	–	Restrict to a single stream.

curl "https://twintone-customer-app.vercel.app/api/v1/analytics?period=30d" \
  -H "Authorization: Bearer tt_live_…"

Response 200

{
  "period": "30d",
  "brand_id": "…",
  "total_streams": 47,
  "total_viewers": 12840,
  "total_minutes": 2130,
  "live_now": 1,
  "avg_viewers_per_stream": 273,
  "by_platform": { "youtube": 30, "tiktok": 17 },
  "streams": [
    {
      "id": "…",
      "status": "ended",
      "viewer_count": 410,
      "started_at": "…",
      "ended_at": "…",
      "platform": "youtube",
      "vertical": "live-commerce"
    }
  ]
}

Notes

total_minutes sums completed streams (ended_at - started_at) — a live stream contributes its minutes only after it ends.
Data is near-real-time; a stream appears in analytics as soon as it's created.
For per-event detail, use GET /streams/{id} and webhooks.

← Previous

Streams

Webhooks

Was this page helpful?