Short answer
Create a token in Account → API Token, send it as a Bearer header, and call /api/v1/sites to list your sites or /api/stats/SITE_ID/breakdown, /overview, /series, /realtime or /trends for any report.
Authentication
Create a token in Account → API Token / MCP. Send it with every request:
curl -H "Authorization: Bearer YOUR_TOKEN" https://pubpulse.pro/api/v1/sitesReports
| Endpoint | Returns |
|---|---|
| /api/stats/SITE_ID/overview | totals of the period |
| /api/stats/SITE_ID/series | the same metrics per hour or day |
| /api/stats/SITE_ID/breakdown | a table by one or more dimensions |
| /api/stats/SITE_ID/realtime | the last 30 minutes |
| /api/stats/SITE_ID/trends | pages gaining or losing readers |
Example:
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://pubpulse.pro/api/stats/SITE_ID/breakdown?start=2026-01-01&end=2026-01-31&dims=pathname&metrics=views,viewers&limit=20"Parameters
start, end (YYYY-MM-DD in the site timezone), dims, metrics, base (content or events), sort, order, limit, offset, filters (JSON), compareStart/compareEnd.
Limits
Lite 100 calls per hour, Business 1,000, Enterprise 10,000 (at most 30 per minute).
Try PubPulse free for 30 days
Every feature, no pageview limit, no credit card. Paste one line of code and your first visits show up within seconds.
Start your free trialor click around the live demo first, no sign-up needed