Football data methodology and coverage
Understand career baselines, season reports, update dates and missing observations before comparing records.
Different views describe different scopes
A career baseline is a dated saved record. A season report covers the competitions supplied for that player and season. A match report describes a particular fixture. BallerBase keeps those scopes separate because adding them together without checking for overlap could double-count an event.
Historical references include records such as Transfermarkt career tables and club or federation histories. API-Football supplies supported match, season and league observations. The site’s coverage is not identical for every player, league or year. A profile existing in the archive does not mean every advanced metric is available for it.
Update dates and the word live
Match and standings views use shared saved reports that refresh through the site’s data service. Provider availability and delivery times affect how quickly a new result appears. A checked date records when information was obtained; it is not necessarily the exact moment an event happened.
A historical page or guide can intentionally use a frozen snapshot. The career-comparison guide, for example, uses the recorded 4 November 2026 baseline. Its numbers should not be read as today’s official totals. The guide’s inputs are available here.
Missing values and totals
A supplied zero is different from an unavailable value. When a complete selected total requires an observation that is missing, the result should not silently substitute zero. A partial subtotal needs to be identified as partial. Historical assists and detailed-event statistics require particular attention to collection methods and source definitions.
Calculated measures
Per 90 is a count divided by minutes, multiplied by 90. It requires verified minutes covering the same observations as the count. Percentages and provider ratings are not converted to per 90. Position-based comparisons depend on the sample available; a tracked-player sample must not be labelled as a complete world ranking.
League reports preserve the provider’s competition groups and order. Separate stages should not be flattened into a fabricated single league table. Recorded honours lists are curated entries rather than a promise of an exhaustive count of every local or invitational title.
What to do with a discrepancy
First check dates, competition boundaries and definitions. Then compare the underlying source. Report a suspected error with the specific field and evidence. Use the dates and source references shown with each record when making these checks.
External references: API-Football documentation and the source links shown in the relevant historical or editorial record.