Each plan has a rate for the minute and an allowance for the day (free key) or the month (paid plans). Every response carries both in its headers, so a client can pace itself and never be refused.
x-ratelimit-limit: 60 x-ratelimit-remaining: 58 x-ratelimit-reset: 41 seconds until the minute resets x-allowance-limit: 500 x-allowance-remaining: 487 x-allowance-reset: 34201 seconds until the day resets
Going over
A call past the minute answers 429 rate_limited; a call once the allowance is used answers 429 allowance_used. Both carry a Retry-After header in seconds and a sentence saying when to come back. Allowances renew at 00:00 UTC. There is no overage bill, ever: a refused call is simply refused.
What counts
Only calls that are authorised and understood count. A call refused for its key, its plan or its parameters costs nothing.
| Plan | Endpoints | Window | Rate | Allowance |
|---|---|---|---|---|
| Free key | 16 | Every free endpoint, on results at least seven days old | 60 a minute | 500 a day |
| Live | 44 | In-play and the last thirty days | 120 a minute | 250,000 a month |
| Archive | 43 | The whole archive, but nothing in play | 120 a minute | 250,000 a month |
| Complete | 44 | In-play and the whole archive | 180 a minute | 600,000 a month |
| Analyst | 52 | Everything, including the model endpoints | 240 a minute | 1,000,000 a month |