API Rate Limiting #
Requests are rate-limited based on authentication method.
Rate Limits #
| Authentication | Limit |
|---|---|
| Unauthenticated | 60 requests/hour |
| Cookie/App Password | 120 requests/hour |
| API Key | 300 requests/hour |
Rate Limit Headers #
All responses include:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Maximum requests allowed |
| X-RateLimit-Remaining | Requests remaining |
| X-RateLimit-Reset | Unix timestamp when limit resets |
Rate Limit Exceeded #
When limit exceeded, you receive 429 status:
| Field | Value |
|---|---|
| code | rest_rate_limit |
| message | Rate limit exceeded |
| status | 429 |
Best Practices #
- Cache responses when possible
- Use webhooks for real-time updates
- Batch requests when feasible
Related Topics #
- [API Overview](#)
- [Authentication](#)
- [Error Handling](#)