Read API

The read API gives scripts, spreadsheets, notebooks and internal tools read-only access to a project's numbers: the same overview and insights you see in the dashboard. JSON in, JSON out.

API keys#

Owners and admins create keys in the project's Keys & API page, under API keys (read-only). Give each key a name that says what uses it.

• Keys start with vxr_.
• A key reads one project only, and can't change anything.
• A key is shown once, right after you create it. Copy it then: it can't be shown again. The list only shows its first characters, who created it and when it was last used.
• You can revoke a key at any time. Requests with a revoked key get a 401.

Making requests#

Send the key as a bearer token. Your project id is in the dashboard's address bar, right after /projects/.

curl -H "Authorization: Bearer vxr_YOUR_API_KEY" \
  "https://api.anyanalytics.org/api/v1/projects/<projectId>/overview?range=30d"

Endpoints

All paths are relative to /api/v1/projects/:projectId.

Overview#

The overview takes these parameters, in the query string or the JSON body:

curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"range":"custom","from":"2026-09-01","to":"2026-09-30","filters":[{"dim":"channel","value":"Organic Search"}]}' \
  "https://api.anyanalytics.org/api/v1/projects/<projectId>/overview"

The response has the headline totals and the previous period's, the chart series and their buckets, the breakdowns for every dimension, your goals and the revenue currency. Times are wall-clock in the project's timezone. The numbers are defined in The dashboard.

Insight queries#

POST /query takes { "query": { ... } } with the same query a saved insight holds. The easiest way to write one is to build it in the dashboard, save it, and read its query from GET /insights. A query without a kind is a trend; funnels, retention and paths set "kind" to "funnel", "retention" or "paths".

curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"query":{"series":[{"event":"$pageview","metric":"unique_users"}],"dateRange":{"from":"-30d"},"interval":"day"}}' \
  "https://api.anyanalytics.org/api/v1/projects/<projectId>/query"

curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"query":{"kind":"funnel","steps":[{"kind":"page","value":"/pricing"},{"value":"signup_completed"}],"dateRange":{"from":"-30d"}}}' \
  "https://api.anyanalytics.org/api/v1/projects/<projectId>/query"

Date ranges are relative ("-24h", "-30d") or a YYYY-MM-DD day, read in the project's timezone, and can cover up to two years.

Limits and caching#

• Each key can make 300 requests per minute.
• Each key can have 8 requests in flight at once.
• Results are cached for a minute, so asking more often than that returns the same numbers.
• Browsers can call the API directly (CORS is open), since the key travels in a header.

Errors#

Errors come back as JSON with an error field. When a response has a Retry-After header, wait that many seconds before trying again.