football.json

Free open public domain football data in the JSON (JavaScript Object Notation) data interchange format.

Leagues include:

English Premier League, Championship, League One, League Two
Deutsche Bundesliga, 2. Bundesliga, 3. Liga
Spanish Primera División ("La Liga"), Segunda División
Italian Serie A, Serie B
French Ligue 1, Ligue 2
and more

Example - Premier League 2015/16 Match Schedule (Fixtures and Results) - 2015-16/en.1.json:

{
  "name": "Premier League 2015/16",
  "matches": [
        {
          "round": "Matchday 1", 
          "date":  "2015-08-08",
          "team1": "Manchester United",
          "team2": "Tottenham Hotspur",
          "score": { "ft": [1, 0] }
        },
        {
          "round": "Matchday 1", 
          "date":  "2015-08-09",
          "team1": "Arsenal",
          "team2": "West Ham United",
          "score": { "ft": [0, 2] }
        },
        ...
  ]
}

Example - Premier League 2015/16 Clubs - 2015-16/en.1.clubs.json:

{
  "name": "Premier League 2015/16",
  "clubs": [
    {
      "name":    "Chelsea",
      "code":    "CHE"
    },
    {
      "name":    "Arsenal",
      "code":    "ARS"
    },
    {
      "name":    "Manchester United",
      "code":    "MUN"
    },
    ...
  ]
}

How to Use the Public JSON API Service - No API Key Required ;-)

Use the "raw" links served by GitHub ( otherwise you get the complete "formatted" GitHub page). Example:

$ curl https://raw.githubusercontent.com/openfootball/football.json/master/2015-16/en.1.clubs.json

Updates / Contributions Welcome - Please Update the Football.TXT Sources

Note: The Football.JSON files get (auto-)generated using the datasets in the Football.TXT format, thus, please do NOT edit the (auto-)generated JSON files but the Football.TXT sources in the country repos e.g.:

English Premier League, Championship, League One, League Two in /england
Deutsche Bundesliga, 2. Bundesliga, 3. Liga in /deutschland
Spanish Primera División ("La Liga"), Segunda División in /espana
Italian Serie A, Serie B in /italy
French Ligue 1, Ligue 2 in /france
and so on

and than (auto-)generate the football.json updates. If you only edit / patch the (auto-)generated JSON files without updating the sources than your changes will get lost / overwritten with the next update.

Do-It-Yourself (DIY) - How To (Auto)-Generate and Update the football.json Datasets

If you want to help out updating the (auto-)generated football.json datasets right here from the sources - you are more than welcome. See the yorobot/football.json build scripts to get started or use your very own.

Add Your Leagues and Tournaments!

Any leagues or tournaments missing? Contributions welcome! For starting your own repo from scratch see the League Quick Starter Kit.

More - Add Your Scripts Here

Enrique Lopez Magallon (@enadol) writes:

Greetings! I started coding the following python robot to read the .txt files (for instance, "1-bundesliga-i.txt)" and generate an emulated version of the JSONs featured in football.json.

https://github.com/enadol/fbjsonrobot

Just make sure the proper .txt file is on the same folder, launch the file launch.py and that's (almost) it! For other leagues, adapt is required.

It's still not perfect, but that's Github is for! 😄

Have fun! ⚽️ ⚽️

Nurgazy Nazhimidinov (@nurgasemetey) writes:

I use [the football.json datasets] in my tool.

Basically it compares the last season and this season head-to-head results of the [English Premier League] team.

Here is the link: https://compare-last-season.netlify.app/

Here is the source code: https://github.com/nurgasemetey/compare-last-season

License

The football.json schema, data and scripts are dedicated to the public domain. Use it as you please with no restrictions whatsoever.

Questions? Comments?

Send them along to the Open Sports & Friends Forum/Mailing List. Thanks!

openfootball/football.json

openfootball

Reviews

Repository Details