Limits and headers
Two limits per plan, calls a minute and calls a day, what counts, when each resets and the headers that tell you.
Each plan has two limits: calls a minute, which keeps the pace even, and calls a day, the quota. Only successful calls count against the quota; an error does not use one up, and /v1/usage never does.
| Plan | Calls a minute | Calls a day |
|---|---|---|
| Free key | 10 | 50 |
| Match Week | 60 | 5,000 |
| Archive | 120 | 25,000 |
| Pro | 180 | 50,000 |
| Analyst Pro | 300 | 100,000 |
When they reset
The minute resets on the minute; the day at midnight UTC. /v1/usage shows today's and this month's calls, both limits, what is left and when each resets.
The headers
Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset for the minute (the reset as a Unix time), X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset for the day, and X-Plan. Read them rather than counting yourself.
Too fast, or out for the day
Two different answers, both 429 with a Retry-After in seconds. rate_limited means slow down: wait the few seconds and carry on. quota_exceeded means the day's calls are used: it says when they reset, and /pricing has the plans with more.