Skip to main content
Zenovay

API & Integrations

42

Integrate Zenovay with your stack. Access the REST API, configure webhooks, and set up framework-specific integrations.

API Error Handling

Handle Zenovay API errors gracefully - error codes, retry strategies, and debugging techniques. Learn about api in this API integrations guide.

API Overview

Introduction to the Zenovay API - capabilities, authentication, and getting started with programmatic access. Learn about api in this API integrations guide.

Audit Log Export

Export your team's audit log to NDJSON, CSV, or JSON for compliance, archival, and downstream analysis. Available on the Pro plan and above.

Authentication & API Keys

Manage API authentication - create keys, set permissions, and secure your API access. Learn about api in this API integrations guide.

Custom Framework Integration

Integrate Zenovay with any JavaScript framework - vanilla JS, Svelte, Angular, and custom implementations. Explore integration setup and best practices.

Data Import

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

How does Zenovay track file downloads on my website?

Zenovay automatically records file downloads when visitors click download links — no code changes required. Here's what gets tracked, where to view it, and how to opt out a specific link.

Fathom Importer — Import your Fathom Analytics history

Bring your recent Fathom Analytics data into Zenovay using a read-only API key and your site ID. Idempotent, Pro+ feature.

Framer Integration

Add Zenovay analytics to your Framer site through Site Settings → Custom Code → Start of head. Works on the published site (not preview).

GA4 Importer — Import your Google Analytics history

Bring your last 90 days of Google Analytics 4 daily aggregates into Zenovay in one click. OAuth-based, idempotent, Pro+ feature.

How does the API work, and how do I get an API key?

Zenovay's REST API uses Bearer tokens that start with zv_. Here's how to generate, scope, and revoke them, plus a 30-second hello-world request.

Ghost Integration

Add Zenovay analytics to your Ghost publication through Settings → Code Injection → Site Header. Works on every Ghost plan including self-hosted.

How do I integrate GitHub for deploy markers?

Connect Zenovay to your GitHub repositories to surface commit markers on your visitor chart, so you can correlate releases with traffic shifts.

How do I integrate Google Search Console?

Connect Zenovay to your Google Search Console property to pull impressions, clicks, and queries into the same dashboard as your session data.

Matomo Importer — Import your Matomo history

Bring your historical Matomo analytics data into Zenovay through the Matomo Reporting API. Idempotent, Pro+ feature.

Next.js Integration

Integrate Zenovay with Next.js - App Router, Pages Router, and server-side tracking support. Learn about nextjs in this API integrations guide.

How do I integrate Paddle for revenue tracking?

Connect Zenovay to your Paddle Billing (v2) account to attribute revenue back to traffic sources, campaigns, and individual visitors. Sandbox-first setup with a single API key and webhook signature verification.

How do I integrate PayPal for revenue tracking?

Connect Zenovay to your PayPal account to attribute revenue back to traffic sources, campaigns, and individual visitors. Sandbox-first setup with three credentials and webhook signature verification.

Rate Limits & Best Practices

Understand API rate limits - quotas, headers, and strategies for efficient API usage. Learn about api in this API integrations guide.

React Integration

Integrate Zenovay with React applications - tracking, hooks, and component-based analytics. Learn about react in this API integrations guide.

REST API Reference

Complete REST API reference - all endpoints, parameters, and response formats for the Zenovay API. Learn about api in this API integrations guide.

Custom events: how do I send a custom event from JavaScript?

Use the global window.zenovay() function to send a named event with optional properties. Here's the API and a few common patterns.

Google Tag Manager: routing Zenovay through a first-party proxy

Load Zenovay through Google Tag Manager and route tracking through your own domain (a first-party proxy) to reduce ad-blocker loss. Here's the real setup.

Server-Side Tracking

Send events and pageviews to the Zenovay tracking endpoint from your server for ad-blocker immunity and full control over collection.

Shopify: tracking checkout completion in Shopify

Capture every successful Shopify checkout as a Zenovay revenue event using Shopify's native order-status page or the customer-events pixel.

Shopify Integration

Add Zenovay to Shopify - automatic e-commerce tracking, revenue attribution, and customer analytics. Learn about shopify in this API integrations guide.

Simple Analytics Importer — Import your Simple Analytics history

Bring your historical Simple Analytics data into Zenovay via public domain stats, CSV export, or API key. Idempotent, Pro+ feature.

How do I track internal site searches on my website?

Zenovay automatically captures searches from common URL parameters, or you can report SPA searches manually with one tracker call. Here's how.

Slack: how do I get alerts in Slack?

Send Zenovay automation alerts to a Slack channel using an incoming webhook URL and an automation rule.

Squarespace Integration

Add Zenovay analytics to your Squarespace site through Settings → Advanced → Code Injection → Header. Requires Business plan or higher.

How do I query my analytics programmatically (Stats API)?

Query Zenovay's analytics data over HTTP — totals, time series, and breakdowns by page, country, browser, and more. Plausible-compatible parameter shape for easy migration.

How do I integrate Stripe for revenue tracking?

Connect Zenovay to your Stripe account to attribute revenue back to traffic sources, campaigns, and individual visitors. Paste a restricted Stripe API key and Zenovay wires up the rest.

Vue.js Integration

Integrate Zenovay with Vue.js applications - Vue 3, Nuxt, and composition API support. Learn about vue in this API integrations guide.

Warehouse export to AWS S3

Push your daily Zenovay analytics aggregates to your own AWS S3 bucket on a schedule. Available on the Scale plan and above.

Webflow: setting up Zenovay on a Webflow form-submission goal

Track form submissions on a Webflow site as Zenovay goals. Two approaches — the simple URL-match goal and the more reliable custom-event approach.

Webflow Integration

Add Zenovay analytics to your Webflow site through Site Settings → Custom Code → Head. Works on every paid Webflow Site Plan.

Webhooks

Configure outbound webhooks to receive real-time notifications from Zenovay when platform events occur, and learn how Zenovay handles inbound payment webhooks internally.

Real-Time Data Access

Build live dashboards on top of Zenovay - polling strategies, the External API, and where real-time data comes from.

Wix Integration

Add Zenovay analytics to your Wix website through Settings → Custom Code → Head. Works on Wix Premium and above; includes Wix Velo developer hooks.

WordPress Integration

Add Zenovay to WordPress - plugin installation, WooCommerce support, and theme integration. Learn about wordpress in this API integrations guide.

WordPress: deeper FAQ on adding the tracker to WordPress

Answers to the most common follow-up questions about running Zenovay on WordPress — caching, multisite, cookieless/consent, and conflicts with other analytics tools.

Zapier: connecting Zenovay to Zapier

Trigger zaps from Zenovay events — goal completions, traffic spikes, error spikes, uptime changes — by pointing a Zenovay webhook at a Zapier Catch Hook.