Usage Limits
Understanding how events, clicks, and API usage are tracked.
Event Limits by Tier
Monthly event limits are tracked per account (across all projects):
- •Free: 25,000 events/month
- •Hobby: 500,000 events/month
- •Pro: 2,000,000 events/month
- •Max: Unlimited events
What Counts as an Event?
Events are tracked when you send data to the /api/events/ingest endpoint.
Both test and live API keys count towards your monthly limit.
Event usage is tracked per project. All API keys (test and live) for the same project share the same event quota.
Examples of events that count:
- •User signups (
user_signup) - •Button clicks (
button_click) - •Purchases (
purchase_completed) - •Page views, form submissions, custom events, etc.
What Doesn't Count?
The following are tracked separately and do NOT count towards your monthly event limit:
- •Heatmap clicks - Click tracking data sent to
/api/clicks/ingest - •API queries - Reading events via
/api/events/get - •Dashboard views - Viewing analytics in the web dashboard
Heatmap clicks are unlimited on all plans (Max tier required to access the feature).
Rate Limits
API rate limits prevent abuse and ensure system stability:
- •Event ingestion: 100 requests per minute per API key
- •Query endpoints: Authenticated session-based (no hard limit)
Rate limit headers are included in API responses:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1733234567Data Retention
Event data is retained based on your subscription tier:
- •Free: 7 days
- •Hobby: 60 days
- •Pro: 180 days
- •Max: 3 years
Events older than your retention period are automatically deleted. Export important data regularly using the dashboard or API.
Monitoring Usage
Track your current usage in real-time:
- •Visit the Billing page in your dashboard
- •View monthly event count and limit progress
- •Get notified when approaching your limit (coming soon)