Docs
API keys and webhooks
Skip this entire page unless a developer or an automation tool needs your numbers. Everyday analytics do not require an API key.
Create a key
- Open API & Webhooks (your plan must be Active).
- Select the website if the key should be limited to one site.
- Name the key (for example “Zapier”), click Create Key, and copy the secret immediately — Visitorly will not show it again.
Send requests with Authorization: Bearer YOUR_KEY or X-API-Key.
- Events:
GET /api/v1/events?siteId=…&days=7 - Metrics:
GET /api/v1/metrics?siteId=…&days=14(includes sheet-friendly rows)
Revoke a key on the same page if it leaks. Do not put keys in public websites or screenshots.
Webhooks
Paste an HTTPS URL (Zapier/Make “catch hook”). Visitorly can POST metrics.daily and events.export with a signing secret shown once. Disable or delete the webhook if you stop using it.
For a human-readable file instead, use Reports or Sites → Export Events (JSON).
Next: FAQ →
If you are stuck, pick the matching guide
These pages use the same names as the dashboard sidebar. Open Setup Guide while signed in for the interactive checklist.
Start here
- What is Visitorly?
Plans, who does what, data isolation
- Getting started
Choose a plan, add a site, first install
- In-app Setup Guide
Signed-in checklist (same steps, inside the dashboard)
- FAQ
Empty charts, WordPress zip, JSON export, refunds
Put Visitorly on the website
- Install the tracker
WordPress, GTM, HTML, Shopify, Next.js, CNAME
- Connect Google
Optional GA4 and Search Console
- Paid Ads Hub
Meta, Google, TikTok Ads, Blended CAC & Guardrails
- Connect Clarity
Optional Microsoft Clarity project
Read the numbers
- Overview
KPIs, Traffic Growth notes
- Real-Time
Live visitors after install
- Events
Automatic conversions and named goals
- Audience
Map, new vs returning
- Acquisition
Sources, AI traffic, Search Console
- Paid Ads
Multi-channel ROAS, Blended CAC & Fatigue Guardrails
- AI Insights
Written digest of your metrics
- Portfolio
All websites in one table
- Reports and share links
PDF, CSV, Client Snapshot URL
Manage the account
- Sites
Add a domain, snippets, JSON export
- Team and alerts
Invites, roles, pulse, tracker-down
- Profile, password, 2FA, billing
Join date, period end, last-4, auto-renewal
- API and webhooks
Keys for Zapier / Make — optional
Legal
- Privacy Policy
Accounts, tracker events, retention, export
- Terms of Service
Plans, Whop checkout, acceptable use
- Cookie Policy
Session, share-link, tracker IDs
- Refund Policy
Whop or offline billing, cancellations