Stats API
Pull your numbers into spreadsheets, dashboards or your own code. The API returns the same numbers as the dashboard.
Create an API key
Create a key under Team & API in the dashboard (up to 10 per account). The key starts with ns_ and is shown only once, so store it somewhere safe. You can delete a key at any time, and it stops working straight away. Keep keys on your server and never put them in browser code.
Get stats
GET /api/v1/stats with your key in the Authorization header.
| Parameter | Required | Meaning |
|---|---|---|
site | Yes | Your site ID, the same as data-site |
from, to | Yes | Dates as YYYY-MM-DD, both included, in the site's timezone |
dimension | No | Adds a top list: page, entry_page, source, utm_source, utm_medium, utm_campaign, country, device, browser or os |
limit | No | Rows in the top list. Default 10. |
filter | No | Same filters as the dashboard, as dimension:value. Repeat it to combine filters, for example filter=country:NO&filter=source:Google. |
curl "https://vardeanalytics.com/api/v1/stats?site=YOUR_SITE_ID&from=2026-10-01&to=2026-10-31&dimension=source" \
-H "Authorization: Bearer ns_YOUR_API_KEY"Response
dimension and top are only included when you pass dimension. Durations are in seconds and rates run from 0 to 1.
{
"site": "YOUR_SITE_ID",
"range": { "from": "2026-10-01", "to": "2026-10-31" },
"filters": [],
"summary": { "visitors": 10703, "pageviews": 31796, "visits": 12734, "bounceRate": 0.429, "avgVisitDuration": 118, "viewsPerVisit": 2.5 },
"timeseries": [ { "day": "2026-10-01", "visitors": 341, "pageviews": 1002, "visits": 402, "bounces": 171 } ],
"goals": [ { "goal": "signup", "completions": 354, "converters": 321, "conversionRate": 0.03 } ],
"dimension": "source",
"top": [ { "value": "Google", "visitors": 3515, "pageviews": 9120 } ]
}