FOOTBALL API
Sign inRequest a key
The collectionDocumentationMembershipStatusSupport
Sign inRequest a key
Documentation / Guides

FOOTBALL API RATE LIMITS

Plans and limits

What each plan reads, how many calls it makes, how to see what is left, and how fresh each answer is.

THE PLANS

COMPLIMENTARY KEY$0
  • This season's Premier League
  • 50 calls a day, reset at 00:00 UTC
  • 10 calls a minute
MEMBERSHIP$29 a month, or $299 a year
  • All 68 leagues and competitions, back to 2015/16
  • Live scores
  • 120 calls a minute, no daily ceiling

Membership keeps the same key and opens everything at once. See membership

WHAT IS COUNTED

Every call counts against the minute. Every call counts against the day too, on the complimentary key, except /v1/usage, which you can call as often as the minute allows. The day runs on UTC and starts again at 00:00 UTC.

HEADERS ON EVERY ANSWER

X-RateLimit-LimitintegerCalls a minute on your plan.
X-RateLimit-RemainingintegerCalls left this minute.
X-RateLimit-ResetintegerWhen this minute ends, in Unix seconds.
X-Quota-RemainingintegerCalls left today. Complimentary key only; membership has no daily ceiling.
Retry-AfterintegerSeconds to wait, on a 429 only.

PAST A LIMIT

429rate_limitedToo many calls this minute. Wait for Retry-After seconds.
429quota_exceededThe day's 50 calls are used. They come back at 00:00 UTC; the answer names membership, which has no ceiling.

HOW FRESH EACH ANSWER IS

Answers are kept for a short while so every key is quick. At most:

5 secondsLive scores
5 minutesRecent results, one match and its events, tables, form and head to head
15 minutesFixtures
a dayPast seasons, grounds and the collection

SEE YOUR OWN

/v1/usage gives your plan, your calls today and when the day resets.

Usage/v1/usage
PREVIOUSAuthenticationNEXTPagination