Documentation / Guides
Plans and limits, sports data API
Plans and limitsEvery sport is its own plan. Hold one, several, or Complete for all sixteen. One key reads them all.
The plans
| Plan | Reads | Calls a minute | Calls |
|---|---|---|---|
| Free key | Yesterday, every sport, every endpoint but live and fixtures | 10 | 50 a day |
| A sport plan | That sport in full: live, fixtures, every date held | 120 | 250,000 a month for each sport held |
| Complete | All sixteen sports in full | 240 | 1,000,000 a month |
Sport plans run from $19 to $79 a month. Pay yearly for two months free. Complete is $249 a month. Prices are on the pricing page.
A sport you do not hold
A key with sport plans reads any other sport the way the free key does: yesterday only, and no live or fixtures. The answer says so in meta.access, with the plan that opens the rest.
The headers on every answer
| Header | What it says |
|---|---|
| X-Rate-Limit | Calls a minute on your plan |
| X-Rate-Remaining | Calls left this minute |
| X-Rate-Reset | Seconds until the minute resets |
| X-Quota-Month, X-Quota-Day | Your monthly calls, or the free key's daily calls |
| X-Quota-Used | Calls used so far in that period |
Going over
Over the minute answers 429 rate with Retry-After in seconds. Over the month or the day answers 429 quota, with the time until it resets. Months and days run in UTC. Calls that are refused still count, which keeps a stuck loop from running for free.