Our data & sources

Where does Footlab's data come from?

Footlab relies on two sources and two only: API-Football, a commercial football data provider used under a paid licence, for matches, line-ups, statistics, standings, squads, transfers and injuries; and Wikidata, a knowledge base released under the free CC0 licence, for historical honours predating the provider's coverage. No data is extracted from a third-party website without permission.

In total, the database holds 1,550,471 matches and 487,938 players across 171 countries, with honours going back to 1,900.

What exactly are the sources?

Two sources feed the database, each with an explicit legal framework. A third route, web search, never feeds the database: it is used only to verify a probable line-up or a piece of news at the moment a question is asked.

SourceWhat it providesFramework
API-FootballMatches and scores, line-ups, match and player statistics, standings, squads, transfers, injuries — odds excluded.Paid commercial licence (Ultra plan). Redistribution of the raw database is forbidden: Footlab publishes answers and aggregates, never a dump of the database.
WikidataHonours and competition winners going far beyond the provider's statistical coverage, plus entity identifiers linking a player or club to its public record.Public domain (CC0). Free reuse, attribution nonetheless stated here.
Web search (at question time)Probable line-up announced by the press, news and rumours on paid plans.One-off consultation of public pages to verify a fact. Nothing is stored in the database, nothing is republished verbatim.

Footlab performs no automated extraction of third-party websites to build its database. No data is taken from a competitor, a statistics site or a betting operator.

Which competitions are covered, and since when?

The table below shows the real coverage of the main competitions, read straight from the database when this page is rendered. The “detail” column gives the share of matches for which line-ups and match statistics are available, not just the score.

CompetitionSinceMatchesDetail
Serie AItaly2,0106,46194 %
La LigaSpain2,0106,46094 %
Premier LeagueEngland2,0106,46094 %
Serie ABrazil2,0106,41098 %
Major League SoccerUSA2,0126,34396 %
Ligue 1France2,0106,17693 %
EredivisieNetherlands2,0105,33493 %
Süper LigTurkey2,0115,25494 %
BundesligaGermany2,0105,21894 %
Primeira LigaPortugal2,0104,95094 %
UEFA Europa LeagueWorld2,0144,439100 %
Liga MXMexico2,0163,53695 %
UEFA Champions LeagueWorld2,0113,407100 %
UEFA Europa Conference LeagueWorld2,0212,33199 %
Euro ChampionshipWorld2,008477100 %
World CupWorld2,010331100 %

The database holds far more competitions than those listed here: this table is a representative sample, not an inventory.

How often is the data refreshed?

Each family of data has its own frequency, chosen according to how fast it actually goes stale.

DataFrequency
Scores and events of live matchesEvery minute
League standingsHourly
Injuries and unavailabilitiesDaily
Elo ratingsDaily
SquadsEvery two days, and up to ten days after the transfer window closes
TransfersDaily, with web verification during the transfer window
Prediction accuracyContinuously, no earlier than three hours after each kick-off

What are the known gaps?

This section exists because a complete football database does not exist. Here is what Footlab does not know, written down plainly rather than discovered halfway through an answer.

How can a wrong data point be reported?

A data error can be reported to support@footlab.ai, stating the match, player or club concerned. Corrections coming from the provider are picked up at the next refresh; those coming from Wikidata are fixed at the source, in Wikidata, which benefits everyone.

Footlab (footlab.ai) is an independent software product. It is unrelated to FOOTLAB World, the indoor football centre franchise, and unrelated to Footy Labs.

Ready to know everything about football?