Skip to main content

Your dashboard

Exporting your data

The API, on every plan.

There is no export button on the dashboard yet. The API is the export path, and it is on every plan — this page shows the two commands that get a breakdown out as CSV.

What is available today

The API, on any plan. Every figure the dashboard draws is readable through /api/v1/ — the tiles, the timeseries, every ranked breakdown, goals, funnels, search terms and the crawler panel. Endpoint reference lists them all; getting an API key is where to start.

Ask us, if you would rather not write the calls. Email support@truestat.io with the site and the range and it will be produced for you.

What is not available

A CSV download button. Not on the dashboard, not on a breakdown card, not on the AI panel.

A scheduled export. No emailed weekly CSV, no drop into object storage.

A raw event dump. Nothing gives you one row per page view. The API returns aggregates — totals, buckets and ranked breakdowns — not the underlying rows.

An "export everything" account-level action. Export is per site, per range.

Exporting a breakdown, today

Until there is a button, the API is the way:

curl "https://truestat.io/api/v1/sites/$SITE/breakdowns/path?period=last30d&limit=1000" \
  -H "Authorization: Bearer $TRUESTAT_API_KEY"

To get CSV out of it, jq is enough:

curl -s "https://truestat.io/api/v1/sites/$SITE/breakdowns/path?period=last30d&limit=1000" \
  -H "Authorization: Bearer $TRUESTAT_API_KEY" \
| jq -r '["path","views","unique_visitors"], (.data[] | [.path, .views, .unique_visitors]) | @csv'

The last path segment is the dimension. path ranks your pages; swap it for country, referrer, channel, browser, goal or any of the others in Breakdowns — the CSV command is the same, with the field names changed to match.

Note the limit=1000. The dashboard shows a top-10 or top-20 for display; the API will give you the whole ranked list.

Before you lose data, export

Three moments where this matters, all of them irreversible:

Before cancelling. Data is retained through a grace period and then deleted. See Cancelling.

Before downgrading from Pro to Starter. Retention drops from 5 years to 3, and events older than 3 years are deleted. See Data retention.

Before deleting a site. Immediate and permanent, with no recovery window. See Deleting your data.

Note the awkward one: a downgrade that shortens retention drops the days that fall outside the new window. Ask for what you need before the change, not after. (API access is not the issue — it is on every plan, and always has been; this page used to say a downgrade removed it.)

Coming

A CSV download button on the dashboard is planned, so that a one-off export does not need an API key at all. The API stays either way — it is what a scheduled or scripted export is built on.

Was this page helpful?

Last updated September 17, 2026