Getting started

Rate limits

Requests are rate limited per API key, on a tiered basis. Every response tells you exactly where you stand.

Tiers

Tier	Per minute	Per day
Free	`5`	`50`
Pro	`60`	`2000`

Every response includes your current rate-limit state:

Header	Description
`X-RateLimit-Limit`	Your ceiling for the current window.
`X-RateLimit-Remaining`	Requests remaining in the current window.
`X-RateLimit-Reset`	Unix timestamp (seconds) when the window resets.
`Retry-After`	Seconds to wait before retrying. Sent only on a `429` response.

Once you go over your limit the API responds with 429 Too Many Requests, a Retry-After header, and this JSON body:

json

{
  "error": "rate_limited",
  "retryAfter": 42
}

Back off and retry

Wait at least retryAfter seconds (or until X-RateLimit-Reset) before sending another request. See the Errors page for the full status-code list.

Call the key endpoint to see your tier and today's usage without spending a parse:

GET/key

bash

curl https://api.zyron.pro/api/v1/key \
  -H "Authorization: Bearer zyr_xxxxxxxxxxxxxxxxxxxxxxxx"

json

{
  "tier": "free",
  "limits": { "perMinute": 5, "perDay": 50 },
  "usage": { "day": "2026-07-06", "dayCount": 12 }
}