Ocoya API
Visit Ocoya
  • Getting Started
    • Introduction
    • Quick Start
  • Fundamentals
    • Authentication
    • Rate limits
    • Limitations
      • Date limitations
      • URL file limitations
      • Pagination limitations
  • Endpoints
    • Me
    • Workspaces
    • Social profiles
    • Posts
      • List posts
      • Create post
      • Update post
      • Delete post
  • Change log
    • 2025-05-16
    • 2024-10-10 (breaking)
  • Extra
    • HTTP status codes
Powered by GitBook
  1. Fundamentals

Rate limits

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.

Last updated 7 months ago