429 with a Retry-After header telling you how many seconds to wait.
Default Rate Limits
Enterprise plans have higher limits. Contact support to increase your quota.
Rate Limit Headers
Every API response includes headers that show your current usage window:
Example response headers:
Best Practices
- Cache search results when the same query is run frequently.
- Use
per_page=50to reduce the number of requests needed to paginate results. - Check
X-RateLimit-Remainingbefore bulk operations. - Implement exponential backoff for
429responses. - Distribute large batch operations over time rather than sending all at once.