Data Export

Export your analytics data for custom analysis and reporting.

Data Export

EngageTrack gives you full access to your analytics data. Export it as CSV from the dashboard or use the API for programmatic access.

CSV Export from Dashboard

Every report in the EngageTrack dashboard has a Download CSV button:

Navigate to the report you want to export (Pages, Sources, Countries, etc.)
Apply any filters or date range you need
Click the Download CSV button in the top-right corner

The exported CSV includes all rows matching your current filters, not just the visible page.

API-Based Export

Use the analytics export endpoint to fetch data programmatically:

curl -X GET "https://api.engagetrack.net/api/v1/analytics/export?site_id=YOUR_SITE_ID&period=30d&metric=pageviews" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: text/csv"

Query Parameters

Parameter	Type	Description
`site_id`	string	Your site ID
`period`	string	Time range: `7d`, `30d`, `90d`, `12mo`, or custom `2024-01-01,2024-01-31`
`metric`	string	Export type: `pageviews`, `sources`, `countries`, `devices`, `events`

The response is a CSV file with appropriate Content-Disposition headers for download.

API exports respect the same permissions as the dashboard. You need a valid API key with read access to the site. Generate one in Site Settings -> API Keys.

Full Site Export

Request a complete export of all raw event data for a site:

curl -X POST "https://api.engagetrack.net/api/v1/exports/full" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "YOUR_SITE_ID",
    "start_date": "2024-01-01",
    "end_date": "2024-12-31"
  }'

Response

{
  "export_id": "exp_abc123",
  "status": "processing",
  "estimated_rows": 150000,
  "download_url": null
}

Full exports are processed asynchronously. You will receive an email with a download link when the export is ready. You can also poll the status:

curl -X GET "https://api.engagetrack.net/api/v1/exports/exp_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Full exports can be large. The download link expires after 24 hours. For ongoing data access, use the API-based export with specific date ranges instead.

Export Data Format

Full exports include one row per event with the following fields:

Field	Description
`timestamp`	ISO 8601 event time
`event_type`	`pageview`, `custom`, `outbound`, `download`, `form_submit`, `purchase`, etc.
`url`	Page URL where the event occurred
`referrer`	Referring URL (empty for direct traffic)
`visitor_uid`	Anonymous visitor identifier
`session_id`	Session identifier
`event_name`	Custom event or goal name
`properties`	JSON object of event properties
`country`	Two-letter country code
`device`	`desktop`, `mobile`, or `tablet`
`browser`	Browser name
`os`	Operating system
`revenue`	Revenue amount (for purchase events)
`currency`	Revenue currency code