Rate limit
The API quota is the number of requests you can perform during a quantity of time.
Your API quota depends on your plan:
- free: unauthenticated 5 , authenticated 25 .
- pro: It's based on the plan associated with your API Key, starting from 46,000 .
You can perform HTTP calls as long as you are under your API quota limit.
When you reach the API quota limit, you will experience 429 Too Many Requests, meaning you need to wait until the API quota reset (or upgrade your plan).
When the API quota is reset, you have a fresh start again.
All requests return your current quota on the response:
x-rate-limit-limit: The maximum number of requests permitted in the current window.x-rate-limit-remaining: The number of requests remaining in the current window.x-rate-limit-reset: The time at which the window resets, in UTC epoch seconds.
The free endpoint reports the daily window. With an API key the response reports the quota on your key: the free key resets daily, and paid plans reset at the start of the next month in UTC. Keyed numbers are refreshed in the background, so they can lag the live counter by a few minutes.
The free endpoint and the free API key run up to 2 concurrent requests: per IP address without a key, per key with one. Requests above that limit also get 429, even with quota left, with the ECONCURRENCY error code: wait a second and retry instead of waiting for the reset.
Paid plans don't throttle: you can run as many parallel requests as your quota allows.
If you are hitting the daily quota very often and you want to upgrade your plan, just contact us.