Rate limits

To ensure fair use and system stability, the API applies rate limits based on the user's license tier (premium or basic). Limits apply per endpoint, both hourly and daily.

License Tiers

There are three levels of rate limiting:

• premium: High-volume access

• basic: Standard access

• Default: Applied to unauthenticated or unlicensed users

---

Headers

The following headers are returned with each API response to help you monitor usage:

Header	Description
X-RateLimit-Daily-Limit	Max number of requests allowed per day
X-RateLimit-Daily-Remaining	Remaining requests allowed today
X-RateLimit-Daily-Reset	UNIX timestamp when daily limit resets
X-RateLimit-Hourly-Limit	Max number of requests allowed per hour
X-RateLimit-Hourly-Remaining	Remaining requests allowed this hour
X-RateLimit-Hourly-Reset	UNIX timestamp when hourly limit resets
X-RateLimit-License-Tier	Your current license tier (e.g., premium)

Per-Endpoint Limits

Premium Tier

Endpoint	Hourly	Daily
/event (POST)	50	50
/event/{id} (GET)	1,000	10,000
/events (GET)	5,000	50,000
/event/{id}/sales (GET)	1,000	10,000
/topsellers (GET)	500	5,000
/avg-ticket-price (GET)	500	5,000

Basic Tier

Endpoint	Hourly	Daily
/event (POST)	5	5
/event/{id} (GET)	100	1,500
/events (GET)	100	1,000
/event/{id}/sales (GET)	100	1,500
/topsellers (GET)	100	500
/avg-ticket-price (GET)	100	800