Stats over time endpoint

GET /api/v1/sites/{site}/stats

Returns visitors, pageviews, and bounce rate as time series data grouped by the specified period. Supports comparison with a previous date range.

Example request

curl -H "Authorization: Bearer your-token" "https://pageviews.ai/api/v1/sites/{site_id}/stats?from=2026-03-01&to=2026-03-07&period=day"

Response

Returns an object with visitors, pageviews, and bounceRate metrics. Each metric contains:

• labels — Date labels (e.g., "Mar 1", "Mar 2")
• values — Metric values per period
• total — Formatted total (e.g., "1,234")
• percentage — Percentage change from comparison period

When comparison dates are provided, each metric also includes comparisonValues, comparisonLabels, and comparisonTotal.

Example response

{ "data": { "visitors": { "labels": ["Mar 1", "Mar 2", "Mar 3"], "values": [120, 145, 132], "total": "397", "percentage": 12.5 }, "pageviews": { "labels": ["Mar 1", "Mar 2", "Mar 3"], "values": [340, 412, 378], "total": "1,130", "percentage": 8.2 }, "bounceRate": { "labels": ["Mar 1", "Mar 2", "Mar 3"], "values": [45.2, 42.1, 48.6], "total": "45.3", "percentage": -2.1 } } }

Additional parameters

Parameter	Description
period	Time grouping: day (default), week, or month