HTTP API

Stats and realtime

Totals, daily series, and humans in the last five minutes.

GET /api/sites/{id}/stats

?days=1|7|30&actor=human. Returns period totals and a daily series from rollups. This is what the dashboard sparkline and the MCP query_stats tool read.

curl
curl -H "Authorization: Bearer $V5_API_KEY" \
  "$V5_API_URL/api/sites/$SITE_ID/stats?days=7&actor=human"

GET /api/sites/{id}/realtime

Humans (and human_via_ai) in the last five minutes. Used by the live strip on the dashboard.

Something off? Open an issue · Edit on GitHub