If you're migrating from Fathom Analytics to Zenovay, the Fathom Importer brings your recent daily aggregates into Zenovay so you keep context on the day you switch. The import uses the Fathom API with a read-only API key and your Fathom site ID.
What it imports
- Daily pageviews and unique visitors for the last 90 days
- Top pages, top referrers, top countries (window breakdown)
- Browser, device type, and operating system breakdowns
What it doesn't import
- History older than the last 90 days
- Individual visitor sessions or raw event logs
- Fathom Goals / conversions (aggregate totals only)
- Ecommerce / revenue data
- Real-time data (only completed days; today is always excluded)
How to import
Step 1: Get your Fathom API key
- Log in to your Fathom account at usefathom.com.
- Go to Account → API (in the left sidebar).
- Click Create API key.
- Give the key a descriptive name (e.g. "Zenovay import — June 2026").
- Set the permission to Read-only — Zenovay does not need write access.
- Copy the key; it is shown only once.
Step 2: Get your Fathom site ID
- In Fathom, go to Sites.
- Find the site you want to import. The site ID is the short alphanumeric code shown below the site name (e.g.
ABCDE). You can also find it in the site's URL:app.usefathom.com/sites/ABCDE/...
Step 3: Import in Zenovay
- Open the website you want to import into, then open its settings and select the Import tab.
- In the source picker, choose the Fathom Analytics tile.
- Paste your API key and your Fathom site ID.
- Click Connect and wait for the progress to complete.
The import runs in the background. You can navigate away and come back; the status will be waiting for you on the Import tab, along with the import history.
Step 4: Revoke the API key after import
Once the import completes successfully, go back to Fathom → Account → API and delete or revoke the key you created. Zenovay does not need it after the import is complete, and revoking it limits exposure if the key were ever compromised.
Verify your import
After the import completes, run through this short checklist to confirm the data landed correctly.
- Open any analytics view in your dashboard (for example, pageviews for the last 90 days). The imported data appears immediately, blended with any native data already collected.
- Spot-check 3 random days against your Fathom dashboard. Expect ±5% on pageviews and ±3% on unique visitors — Fathom and Zenovay dedupe visitors differently, so a small gap is normal.
- Imported rows are tagged in the database with
imported_from='fathom', so they sit alongside (not on top of) your native Zenovay data. The Import tab's history shows each completed import and the date range it covered. - Re-import the same period to confirm idempotency. The row count should stay the same — duplicates are impossible because each day is keyed uniquely per website at the database level.
- Once satisfied, revoke the Fathom API key (Step 4 above) if you haven't already.
If any of these checks look off, email support@zenovay.com with the date you imported and which days look wrong. We can spot-fix individual days.
Troubleshooting
"Available on Pro" message
The Fathom importer requires a paid plan. Upgrade your plan →
"Invalid API key"
Make sure you copied the full API key from Fathom — it's only displayed once at creation. If you can no longer see it, delete the old key in Fathom and create a new one. The key must have Read-only or higher permission.
"Site ID not found"
Double-check the site ID in Fathom → Sites. It should be a short uppercase alphanumeric code. If you're using the dashboard URL to find it, extract only the code portion (e.g. ABCDE from app.usefathom.com/sites/ABCDE/). Make sure the API key has access to that specific site.
"No data returned"
If the import completes but shows zero rows, confirm that:
- The last 90 days overlap with the period your Fathom site was actively tracking.
- The site ID matches the site you tracked — not another Fathom site in your account.
- Your Fathom account's data retention includes the last 90 days.
"Authentication error"
The API key you created may have been deleted or expired. Create a fresh read-only API key in Fathom and retry the import.
"Import timed out"
Very large windows can take time. Zenovay retries automatically. If it keeps timing out, retry the import — re-running an overlapping range is safe because each day is keyed uniquely per website.
FAQ
Will it overwrite my native Zenovay data?
No. Imported rows are tagged with imported_from='fathom'. They are stored alongside (not on top of) any native data, so your Zenovay-collected analytics stay intact.
Can I re-import? Yes, anytime. Re-importing overwrites the same date range cleanly — no duplicates, no orphan rows.
Why do I need to revoke the API key after import? Fathom API keys are persistent. Because Zenovay only needs the key for the one-time import, revoking it after the import is complete is a security best practice — you should not leave a key active after it is no longer needed.
Does Zenovay keep my Fathom API key? No. Zenovay uses the key only during the import request and does not store it afterward. After the import, revoke it in Fathom so it can't be used again.
What time zone are the daily totals in? Fathom stores data in UTC. Imported rows use UTC dates, matching the Fathom dashboard.
Will Zenovay see my visitors' personal data? No. The Fathom API returns only aggregate statistics. No individual visitor records, IPs, or user IDs are transferred to Zenovay.
Does this affect my Fathom data? No. The importer is read-only. Zenovay never writes to your Fathom account.
Can I import Fathom Goals? Not in V1. We import daily aggregate totals for pageviews and visitors. Goal / conversion data is on the roadmap for a future version.