Usage Limits

Superjoin API implements rate limiting to ensure fair usage and maintain system stability. Each user is allowed a specific number of API requests within a defined time window.

​

Rate Limit Rules

To prevent excessive usage and ensure system performance, the following rate limits apply:

• 5 requests per minute: You can make up to 5 requests within any 60-second window.
• 50 requests per day: A maximum of 50 requests are allowed in a 24-hour period.

​

Exceeding Rate Limits

If you exceed the rate limits, the API will respond with a 429 Too Many Requests error. You will need to wait until the rate limit window resets before making additional requests.

Response Example:

{
  "message": "Too many requests: You have exceeded the API rate limits."
}

​

Monitoring Your Usage

It’s important to monitor your API usage to avoid hitting the rate limits. Ensure your integration handles the 429 error gracefully and retries after the appropriate waiting period.

​

Need Higher Limits?

If your use case requires higher rate limits, you can request an increase by contacting us at support@superjoin.ai. Be sure to include the reasons for needing the higher limit and details about your usage.