Numbers — API endpoints

Base domain

• https://numbers.streamercatalyst.com

Endpoints

Path	Method	Auth	Description
/api/channels/:id/overview	GET	Session cookie	KPI overview totals (today / stream / 7d / 30d) per metric.
/api/channels/:id/metrics	GET	Session cookie	Time-series metric buckets (?metric=&range=).
/api/channels/:id/sessions	GET	Session cookie	Recent stream sessions, incl. avg/peak viewers (?limit=).
/api/channels/:id/sessions/:sessionId	GET	Session cookie	Session detail — viewer-count snapshot series + avg/peak summary.
/api/channels/:id/subscribers	GET	Session cookie	Live subscriber list (paginated, enriched with resub months).
/api/channels/:id/subscribers/tier-metrics	GET	Session cookie	Tier distribution, type breakdown, and tier-progression insights (?range=).
/api/channels/:id/subscribers/retention	GET	Session cookie	Tenure, retention, loyalty cohorts, and anniversaries (?range=).
/api/channels/:id/acquisition	GET	Session cookie	Acquisition-source breakdown (?range=); /recent lists the latest rows (?limit=).
/api/channels/:id/raids/*	GET	Session cookie	Raid analytics — overview, incoming, outgoing, reciprocity, conversion, sources, network, insights (?range=).
/api/channels/:id/journey/*	GET	Session cookie	Cross-source engagement funnel, per-source comparison, and behavior archetypes (?range=).
/api/channels/:id/patterns/*	GET	Session cookie	Temporal, contextual, and event-driven conversion patterns (?range=).
/api/channels/:id/behavior/*	GET	Session cookie	Multi-session attendance and content-preference analytics (?range=).
/api/channels/:id/hype-train-records	GET	Session cookie	Hype-train all-time-high records (own + shared).
/api/channels/:id/events/recent	GET	Session cookie	Unified recent-events feed (?limit=&types=).
/api/channels/:id/goals	GET/PUT/DELETE	Session cookie	Merged goal config and per-metric overrides (incl. plus_points).
/api/channels/:id/plus	GET/PUT	Session cookie	Plus Program estimate and adjustment-offset config.
/api/channels/:id/streaks	GET/PUT/DELETE/PATCH	Session cookie	Goal-streak summary and per-metric streak-goal management.
/api/channels/:id/eventsub	GET/POST	Session cookie	List and (re-)create this channel’s EventSub subscriptions.
/internal/eventsub	POST	Service binding (internal)	EventSub fan-out receiver (internal, from eventsub-router).
/internal/billing/downgrade	POST	Service binding (internal)	Tier-downgrade handler (internal).

Auth model

• Session cookie endpoints require an active StreamerCatalyst session (set at login via the platform Worker).
• Service binding endpoints are reachable only via Cloudflare service bindings — not from the public internet.
• Public endpoints require no authentication.