HTTP API reference
Comprehensive REST API specifications for /analytics ingestion, /metrics queries, and /health uptime endpoints.
Tracabit exposes a small, stable REST surface. Every endpoint except /health requires a per-project Bearer token in the Authorization header.
POST /analytics ingests an event. The payload supports projectId, sessionId, userId, url, referrer, country, device, event, eventParams, fingerprint, and page context. Returns 200 on success, 401 without a valid key, and 403 for a key scoped to another project.
GET /metrics returns daily aggregates. Query params: date for a single day, or from and to for a range. The response includes users, sessions, pageviews, bounceRate, trafficSources, countries, devices, pages, events, and recent events.
GET /health returns service status and version. GET /projects lists projects for the authenticated key, and POST /projects creates a project with allowed_origins and allowed_referrers.
Tracabit records traffic, events, crashes and web vitals with one script tag, and lets your coding agent read them over MCP.
Start free