Guides
Rate Limits
Understanding API rate limits and how to handle them.
Overview
RelayAPI applies rate limits per API key to ensure fair usage and platform stability.
Default Limits
| Plan | Requests/minute | Requests/day |
|---|---|---|
| Free | 60 | 1,000 |
| Starter | 300 | 10,000 |
| Pro | 1,000 | 100,000 |
| Enterprise | Custom | Custom |
Rate Limit Headers
Every response includes rate limit information:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1709856000Handling Rate Limits
When you hit a rate limit, you'll receive a 429 response:
{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Try again in 45 seconds.",
"details": {
"retry_after": 45
}
}
}Use the Retry-After header or retry_after field to determine when to retry.
Platform Rate Limits
In addition to API rate limits, each social platform has its own rate limits. RelayAPI respects these automatically and queues posts when platform limits are reached. See individual platform pages for platform-specific rate limits.