plain files for football projects
footy-data-kit
Historic English league tables scraped, normalised, verified, and shipped as JSON. Minimal tooling. No API key. No runtime dependency.
Start here
1888-2025
season coverage
138
seasons
375
club metadata records
6 tiers
latest season depth
What is this?
A small data kit for English football history: league tables by season, promotion and relegation summaries, and a sidecar file for club identity metadata.
The maintained dataset is generated from Wikipedia overview pages, validated by local checks, and committed as static files for direct download.
Navigation
Releases
Downloads
latest releaseLatest release assets:
-
all-seasons.jsonFull merged season dataset. 8.6M. json raw -
all-seasons.min.jsonMinified full merged season dataset. 4.4M. min raw -
wiki_overview_tables_by_season.jsonMaintained Wikipedia overview export. 8.6M. json raw -
wiki_overview_tables_by_season.min.jsonMinified Wikipedia overview export. 4.4M. min raw -
club-metadata.jsonClub identity sidecar metadata. 1.9M. json raw
Schema
schema indexHuman-readable JSON Schema references for the published data files.
-
club-metadata.schema.jsonSidecar club identity metadata keyed by clubId. Records combine source-backed history with generated observations from the season tables. view raw -
football-data.schema.jsonMerged English football season dataset. Season records contain a seasonInfo summary and zero or more tierN league-table records. view raw
Use it
curl -L https://github.com/dills122/footy-data-kit/releases/latest/download/all-seasons.min.json \
-o all-seasons.min.json