API

The HTTP API is read-only site analytics. It does not create links or change settings.

Authentication

Create a site API token in Settings → Developers. It starts with pk_. Send it as Authorization: Bearer pk_…. Pulse stores only a hash. Copy the token when it is shown.

Ranges

Query parameter range accepts 24h, 7d, 30d, 90d or month. Times are UTC. Optional currency selects one revenue view. Pulse never mixes currencies into one total.

MCP

The same site token can power the Pulse MCP endpoint at POST /api/mcp for tools that ask for stats, breakdowns and live visitors.

GET /api/v1/stats?range=30d
Authorization: Bearer pk_…

GET /api/v1/breakdown?dim=path&range=7d
Authorization: Bearer pk_…

Breakdown dim: path, referrer (or source), utmSource, utmCampaign, utmMedium, utmContent, utmTerm, country, region, city, device, browser, os.