Zenovay lets you pull your data out for external analysis, reporting, or integration with other business tools. There are two ways to get it: the data export tool (download or schedule CSV/JSON files) and the REST API (query figures programmatically). This article covers both, and how to read your revenue numbers from each.
Info
Zenovay's export produces analytics data — daily aggregates or raw visitor-level rows. It is not a line-by-line accounting ledger of every order. For revenue, the API returns transaction totals and attribution; for a full transaction log, export from your payment provider (Stripe, Paddle, etc.).
Download a data export
Scale PlanThe data export tool lives on the Agency page (owners and admins on the Scale plan or higher).
Open the export tool
Go to Agency → Export.
Pick websites and a date range
Choose one or more of your websites and the period you want to export.
Choose a format
Export as CSV or JSON.
Run the export
Zenovay builds the file and emails you a secure download link when it's ready. Larger ranges are processed in the background.
Export formats
| Format | Best For |
|---|---|
| CSV | Excel, Google Sheets, databases |
| JSON | API integration, developers, custom dashboards |
What's in the export
A data export contains aggregated daily metrics by default (one row per day):
| Field | Description |
|---|---|
| date | The day the metrics cover |
| visitors | Total visitors |
| unique_visitors | Distinct visitors |
| pageviews | Total pageviews |
| bounce_rate | Bounce rate |
| avg_session_duration | Average session length |
Raw exports include visitor-level detail instead — date, session_id, device_type, browser, os, country_code, city, referrer, and the engagement value score for each visit.
Sample CSV output
date,visitors,pageviews,unique_visitors,bounce_rate,avg_session_duration
2026-06-13,1248,3104,982,41.2,138
2026-06-12,1190,2987,941,43.7,142
2026-06-11,1305,3380,1024,39.8,151
Info
Need per-order revenue with source, medium, and campaign attribution? Read it from the REST API instead — that's where transaction-level revenue figures live.
Scheduled exports
Scale PlanAutomate recurring exports so a fresh file lands in your inbox on a schedule.
Open the export tool
Go to Agency → Export.
Create a schedule
Add a new scheduled export, choosing the website(s), metrics, format, and cadence.
Set recipients
Add the email addresses that should receive each export.
Schedule options
| Option | Choices |
|---|---|
| Frequency | Weekly, Monthly |
| Format | CSV, JSON |
| Metrics | Visitors, pageviews, bounce rate, and other analytics metrics |
| Recipients | Email addresses |
Managing schedules
On the same Agency → Export tab you can see all active schedules and pause, edit, or delete them at any time.
Read revenue via the API
Pro PlanThe REST API (Pro plan and up) lets you pull figures programmatically into your own scripts, dashboards, or BI tools. Create a key under Settings → Account → Security & access — keys start with zv_.
Revenue LTV cohorts
curl -G "https://api.zenovay.com/api/external/v1/revenue/{websiteId}/ltv" \
-H "X-API-Key: zv_YOUR_API_KEY" \
-d range=90d \
-d granularity=monthly
The response is JSON containing per-cohort lifetime-value figures plus a summary block. Replace {websiteId} with your website's ID.
Stats endpoints
For aggregate, time-series, and breakdown metrics (including revenue where you've configured revenue tracking), use the stats endpoints:
curl -G "https://api.zenovay.com/api/external/v1/stats/aggregate" \
-H "X-API-Key: zv_YOUR_API_KEY" \
-d site_id=YOUR_WEBSITE_ID \
-d period=30d
The full endpoint list, parameters, and response shapes are in the REST API reference and the machine-readable OpenAPI spec. API responses are returned as JSON.
Common API errors
| Error | Solution |
|---|---|
| 401 Unauthorized | Check the X-API-Key header and that the key starts with zv_ |
| 429 Rate Limited | Slow your request rate — see Rate limits |
| 400 Bad Request | Verify your query parameters |
Export best practices
Choose the right format
| Use Case | Recommended Format |
|---|---|
| Spreadsheet analysis | CSV |
| System integration | JSON |
| Programmatic queries | REST API |
Date range considerations
- Allow a little time for very recent data to settle before exporting.
- Exports respect your plan's data-retention window.
- Match the range to your business reporting periods.
Large data sets
For large or continuous data needs:
- Use the REST API or a scheduled export instead of repeated manual downloads.
- On the Scale plan, connect a warehouse export to stream daily aggregates straight into S3 (and, where available, BigQuery or Snowflake). See Warehouse export to S3.
Common export uses
Financial reporting
- Monthly revenue reconciliation
- Audit documentation
Marketing analysis
- Campaign ROI analysis
- Channel performance
- Attribution modeling
Business intelligence
Feed exported data into tools like:
- Tableau
- Power BI
- Looker
- Custom dashboards
Troubleshooting
Export not arriving
If your download link doesn't arrive:
- Check your spam folder for the export email.
- Verify the recipient address on a scheduled export.
- Try a smaller date range.
Data seems incomplete
If data appears missing:
- Verify the date range.
- Confirm the period is within your plan's retention window.
- Allow recent data time to finish processing.
File doesn't open correctly
- Confirm the file extension matches the chosen format.
- CSV/JSON files are UTF-8 encoded.
- Try a different application.
Privacy & security
Exported data
Daily-aggregate exports contain analytics metrics, not personal identifiers. Raw exports include session and device detail; treat those files as sensitive.
Access control
- Export and scheduled-export tools require an owner or admin role on the Scale plan or higher.
- Limit the recipients on scheduled exports to people who should see the data.
Data retention
Export files are:
- Delivered to your email or system, not stored long-term by Zenovay.
- Your responsibility to secure once downloaded.