X-RateLimit-Limit on each response, which always reflects your actual limit for that endpoint in the current window. The standard allowance is on the order of 60 requests per minute per endpoint. When you exceed the limit, the API returns 429 Too Many Requests with a JSON error body.
All API keys and users in your organization share the same quota. The limit applies separately to each endpoint — for example, search and poll each have their own window.
Response headers
Handle 429 errors
1
Read the reset time
Parse
X-RateLimit-Reset and wait until that timestamp before retrying
the same endpoint.2
Backoff between polls
When polling research results, use a 2–5 second interval instead of
tight loops.
3
Avoid duplicate research
A
duplicate poll status means the record was already researched — do
not resubmit research for the same searchResultId.Related
- Credits — what uses credits and how to check your balance
- Error codes — HTTP 400, 401, 403, 422, 429, and more
- Troubleshooting — failed research and auth errors