Ocoya API
Search
K
Comment on page

Rate limits

Information about our API rate limitation

Hard limit

Our API has a global user rate limit of 60 requests per minute. This means that a maximum of 60 requests can be sent at 1 minute intervals using the same API key.

Rate limits

If you exceed your rate limit you will receive a 429 error response with a "Too Many Attempts" message. If you think you will be hitting these limits, please implement a backoff strategy that would even out the requests over time.
Response Code: 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
{
"message": "You've exceeded the request limit."
}

Rate limit headers

Each API request comes back with headers related specifically to rate limiting.
Header
Meaning
X-RateLimit-Limit
The maximum number of API requests that the user can make per minute.
X-RateLimit-Remaining
The remaining number of API requests that the user can make per minute.
X-RateLimit-Reset
A timestamp indicating when the remaining limit resets.