Skip to main content
Free15 minutesIntermediate

Data Import

Data Import: Import historical analytics data from Plausible, Matomo, Simple Analytics, and Fathom into Zenovay. Explore this API integrations guide for details.

importmigrationdataplausiblega4
Last updated:

Import historical analytics data into Zenovay to preserve your numbers when migrating from another analytics platform. You need to be an owner or admin of the target website to run an import.

The Plausible CSV/ZIP import is available on every plan. The other connectors (GA4, Matomo, Simple Analytics, Fathom) are a Pro+ feature.

Supported Import Sources

SourceStatusMethod
Plausible AnalyticsSupportedCSV/ZIP upload
Google Analytics 4SupportedOAuth — last 90 days of daily aggregates
MatomoSupportedCSV export or live API (token_auth)
Simple AnalyticsSupportedPublic domain, CSV, or API key
Fathom AnalyticsSupportedRead-only API key + site ID
Mixpanel, Amplitude, othersOn the roadmap

Each source has its own connector and step-by-step guide:

Where to import

The easiest way to import is from inside the app:

  1. Open your website's detail page (Domains → your site)
  2. Go to Settings → Import
  3. Pick the source tile and follow the connector

The rest of this guide covers the Plausible import in detail, including the API endpoints for scripted migrations.

Plausible Import

The simplest way is the in-app uploader (Settings → Import → Plausible), which accepts the CSV/ZIP export from Plausible directly. The API endpoints below are for scripted migrations.

Import Endpoint

POST /api/import/{websiteId}/plausible

{websiteId} is the website's ID (a UUID), not its tracking code — copy it from the address bar of your website's dashboard or from Settings. This endpoint imports your Plausible Analytics data into that website.

How to Import

  1. Export your data from Plausible Analytics
  2. Send the data to the Zenovay import endpoint:
curl -X POST "https://api.zenovay.com/api/import/YOUR_WEBSITE_ID/plausible" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d @plausible-export.json

The endpoint also accepts a multipart/form-data upload (the CSV/ZIP file under the file field) or raw text/csv.

Check Import History

View past imports for a website:

GET /api/import/{websiteId}/history
curl "https://api.zenovay.com/api/import/YOUR_WEBSITE_ID/history" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN"

Check Import Status

Monitor the progress of a specific import:

GET /api/import/{importId}/status
curl "https://api.zenovay.com/api/import/IMPORT_ID/status" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN"

Import Statuses

StatusDescription
pendingImport queued
processingCurrently importing
completedSuccessfully finished
failedImport failed

Migration Tips

Before Importing

  1. Create the target website in Zenovay first
  2. Make sure the domain matches your Plausible site
  3. Export your data from Plausible before cancelling your subscription

After Importing

  1. Check the import status to confirm completion
  2. Verify the imported data appears in your Zenovay dashboard
  3. Ensure the date range in your dashboard includes the imported dates
  4. Install the Zenovay tracking script to begin collecting new data:
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

Migrating from Other Platforms

For platforms that are not yet on the supported list, you can still migrate to Zenovay:

  1. Keep historical data in your current platform for reference
  2. Install the Zenovay tracking script to start collecting new data immediately
  3. Run both platforms in parallel for a transition period to compare data
  4. Decommission the old platform once you are confident in the Zenovay data

Installing the Tracking Script

Add this to your site to start collecting data with Zenovay:

<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

Troubleshooting

Import Fails

Check:

  • Website ID is valid
  • Authentication token is correct
  • Data format matches Plausible export format
  • File size is within limits

Data Not Appearing

Verify:

  • Import status shows completed
  • Date range in dashboard includes imported dates
  • Website ID matches the target website

Next Steps

Was this article helpful?