Introduction
Send your product and game events to TopStats and turn them into live dashboards, funnels, retention, and alerts.
TopStats Analytics is an event analytics product. You send events (things
that happen in your app or game, like player_join or purchase) from your
backend, and TopStats turns them into live dashboards, funnels, retention grids,
and alerts.
Base URL
The app and the API share one origin. Every ingest and API path lives under
/v1/ on it.
https://topstats.gg/v1/Where to go next
Getting started
Create a key and send your first event in a few minutes.
Core concepts
Workspaces, environments, events, and actors, in plain terms.
Sending events
The event payload, with copy-paste curl and JavaScript examples.
Dashboards
Build a canvas of widgets pinned to an environment and time range.
Alerts
Get notified when a metric crosses a line, spikes, or goes quiet.
API reference
Every endpoint, its auth, and what it does.
What you can build
- Dashboards of numbers, time series, tables, funnels, retention grids, histograms, and activity heatmaps.
- Actors to follow the person or server behind your events over time.
- Alerts that watch a metric and notify Discord, Slack, a webhook, or email.
- Scheduled digests that email a dashboard summary on a cadence.
- Sharing and embedding so a dashboard can be a public link or an iframe.
Today you can send events from Node.js, JavaScript, TypeScript, or any HTTPS client (curl, fetch, your backend's HTTP library), and from any OpenTelemetry SDK or Collector. More language SDKs and game-server plugins are on the way.