Match data

Per match

Four files sit under every match URL. Take the match page’s address and append the filename:

https://cornerflick.com/football/{competition}/matches/{match}/data.json

Full match record data.json

Everything: record fields, timeline with per-event anchors, both team sheets, team statistics, and the provenance block.

Timeline events events.csv

One row per event — minute, stoppage time, type, side, player, assist, and the anchor that links to it on the page.

Lineups and bench lineups.csv

One row per player — side, formation, coach, role, shirt number, position, captaincy, and our player slug where we hold a profile.

Team statistics stats.csv

One row per measure — possession, shots, corners and the rest, as home-vs-away pairs with their unit.

Per season

Every result in a competition, one row each, with each row carrying the URL of its own match record:

https://cornerflick.com/football/leagues/{competition}/results/season.csv
https://cornerflick.com/football/leagues/{competition}/results/season.json

Browse them at /football/leagues.

What is in the data, and what is not

• A field nobody recorded is absent, never zero and never an empty string. You can always tell “not recorded” from “recorded as none”.
• Scores, timelines, lineups, statistics, venue, matchday and the main referee come from the match feed.
• Attendance, assistant referees, the fourth official and VAR are ours — the feed does not report them, so they appear only where an editor has entered them from an official source. They are never estimated.
• Anything corrected after full time carries a dated note, in the file as well as on the page.
• Every file states when it was last refreshed. A file is never fresher than thelast_updated_at in its meta block.

Licence

Published under CC BY 4.0. Use it, change it, build on it, including commercially — the one condition is credit. The credit we ask for is Data by Cornerflick — cornerflick.com, as a link where a link is possible.

The licence covers the compilation Cornerflick publishes — the selection, structure and annotation of these files. Underlying match facts are sourced from our data providers, who set their own terms; if you plan to redistribute at scale, check with them and with us first.

Found a mistake, or need something else?

Corrections are welcome and get published with a dated note. Tell us what is wrong, or what shape of data would be useful. If you are writing something with it, say so — we will help.