Rate limits
The amount of requests you can do before you run into our rate limit depends on your subscription. With our free API key, you can make 10K requests per month. If you need more you can upgrade very easily.
Without a key, you can still make a very limited amount of requests, so you can quickly test if our endpoints fit your needs, or debug a little bit during development. The unauthenticated requests are not guaranteed to work, so we advise you to get a key to not unexpectedly run into the rate limiter.
Types of rate limiting
We have rate limits for several time intervals. We protect against burst requests by limiting the free keys to about five requests per second. Our free key is limited to 10K requests per month. Unauthenticated requests are limited much more per month, and have limits per minute and hour as well. The current unauthenticated rate limits might change in the future to whatever we see fit; for guaranteed rate limits get one of our free keys.
Rate limit response headers
Every request you do returns information about the rate-limit, so your application can adapt before reaching the limit.
| Header | Description |
|---|---|
| X-RateLimit-Limit-Second | The maximum amount of requests in a second |
| X-RateLimit-Limit-Minute | The maximum amount of requests in a minute |
| X-RateLimit-Limit-Hour | The maximum amount of requests in an hour |
| X-RateLimit-Limit-Month | The maximum amount of requests in a month |
| X-RateLimit-Remaining-Second | The amount of requests you can still do in a second |
| X-RateLimit-Remaining-Minute | The amount of requests you can still do in a minute |
| X-RateLimit-Remaining-Hour | The amount of requests you can still do in a hour |
| X-RateLimit-Remaining-Month | The amount of requests you can still do in an hour |
| RateLimit-Limit | This is the rate-limit that is the first to run out. E.g. when you can still do 10000 requests this month, but only 5 this minute, it will show 5 |
| RateLimit-Reset | This will tell you the amount of seconds remain until the quota of your lowest rate-limit will be restored to its maximum |
| RateLimit-Remaining | The amount of requests remaining for the lowest remaining limit |