{"id":16578427,"url":"https://github.com/schochastics/football-data","last_synced_at":"2025-07-29T20:35:34.950Z","repository":{"id":123114702,"uuid":"247826275","full_name":"schochastics/football-data","owner":"schochastics","description":"football (soccer) datasets","archived":false,"fork":false,"pushed_at":"2024-11-10T18:09:35.000Z","size":36024,"stargazers_count":47,"open_issues_count":1,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-09T04:12:20.945Z","etag":null,"topics":["data-analysis","data-science","data-visualization","dataset","football-data","rstats","soccer-data"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/schochastics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-16T22:12:19.000Z","updated_at":"2025-03-01T11:48:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"0832f881-2fb0-43c1-b84f-56f9d9bd841a","html_url":"https://github.com/schochastics/football-data","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schochastics%2Ffootball-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schochastics%2Ffootball-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schochastics%2Ffootball-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schochastics%2Ffootball-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schochastics","download_url":"https://codeload.github.com/schochastics/football-data/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243830922,"owners_count":20354850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-analysis","data-science","data-visualization","dataset","football-data","rstats","soccer-data"],"created_at":"2024-10-11T22:14:21.661Z","updated_at":"2025-07-29T20:35:34.937Z","avatar_url":"https://github.com/schochastics.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"**This repository is made available under the [Open Data Commons Attribution License](https://opendatacommons.org/licenses/by/1-0/index.html)**\n\n# football-data\n\nThis repository contains some datasets for football (soccer). \n\n## Updates\n\n(11/2024)\n- Result data now contains all games until end of 2023 as a parquet file\n- `data/goals_time` now includes 23 competitions \n\n## Football Results Dataset\n\n`data/results` contains results of 1,237,935 football games in 207 top-tier domestic leagues and \n20 international tournaments (UEFA EuroLeague/ChampionsLeague,etc.) from\n1888-2023. The data is provided as a parquet file.\n\n### Codebook\n\n| variable       | description                                                     |\n|----------------|-----------------------------------------------------------------|\n| home           | home team name (not necessarily unique)                         |\n| away           | away team name (not necessarily unique)                         |\n| date           | date of match                                                   |\n| gh             | goals for home team (including extra time and penalties)        |\n| ga             | goals for away team (including extra time and penalties)        |\n| full_time      | \"F\"=game ended in 90', \"E\"=extra time, \"P\"=penalty shoot-out    |\n| competition    | country name of league or name of international competition     |\n| home_ident     | unique identifier of home team                                  |\n| away_ident     | unique identifier of away team                                  |\n| home_country   | country of home team                                            |\n| away_country   | country of away team                                            |\n| home_code      | country code of home team                                       |\n| away_code      | country code of away team                                       |\n| home_continent | continent of home team                                          |\n| away_continent | continent of away team                                          |\n| continent      | continent of competition                                        |\n| level          | \"national\"= domestic league, \"international\"= international cup |\n\n### Disclaimer\n\nThis dataset contains errors for older games where sources are not as reliable.\nA big issue are teams that merge/split/dissolve over time, which (I think) I did\nnot resolve consistently over time.\n\nI have gathered this dataset over the course of 10 years and put a lot of effort in\nit (see [worldclubratings.com](worldclubratings.com)). If you use the data for any kind of project, please drop me a line\nor open an issue in this repository. If you have any questions or requests,\nplease open an issue too.\n\n## formations and lineups\n\nThe folder `data/formations` contains lineups and formations datasets \n\n## goals and times\n\nThe folder `data/goals_time` contains details about each scored goal (scorer,\ntime) in the Top 15 European Leagues (according to the UEFA 5 year rating 2004), the Champions League and Euro League, and\na few national cups.\n\n## Links\n\n[worldclubratings.com](http://worldclubratings.com/)\n\nSimilar datasets:  \n\n- [European Soccer Database](https://www.kaggle.com/hugomathien/soccer) (Kaggle)\n- [World Soccer](https://www.kaggle.com/sashchernuh/european-football)  (Kaggle)\n- [International Football Results](https://www.kaggle.com/martj42/international-football-results-from-1872-to-2017) (Kaggle)\n- [engsoccerdata](https://github.com/jalapic/engsoccerdata) (R package)\n- [football-data.co.uk](http://football-data.co.uk/)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschochastics%2Ffootball-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschochastics%2Ffootball-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschochastics%2Ffootball-data/lists"}