football.json

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

Leagues include:

English Premier League
Deutsche Bundesliga
Spanish Primera División ("La Liga")
Italian Serie A
and more

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

{
  "name": "English Premier League 2015/16",
  "rounds": [
    {
      "name": "Matchday 1",
      "matches": [
        {
          "date": "2015-08-08",
          "team1": {
            "key": "manutd",
            "name": "Manchester United",
            "code": "MUN"
          },
          "team2": {
            "key": "tottenham",
            "name": "Tottenham Hotspur",
            "code": "TOT"
          },
          "score1": 1,
          "score2": 0
        },
        {
          "date": "2015-08-09",
          "team1": {
            "key": "arsenal",
            "name": "Arsenal",
            "code": "ARS"
          },
          "team2": {
            "key": "westham",
            "name": "West Ham United",
            "code": "WHU"
          },
          "score1": 0,
          "score2": 2
        },
        ...
      ]
    }
  ]
}

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

{
  "name": "English Premier League 2015/16",
  "clubs": [
    {
      "key": "chelsea",
      "name": "Chelsea",
      "code": "CHE"
    },
    {
      "key": "arsenal",
      "name": "Arsenal",
      "code": "ARS"
    },
    {
      "key": "manutd",
      "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/opendatajson/football.json/master/2015-16/en.1.clubs.json

Automate, Automate, Automate

Note: The JSON files get (auto-)generated using the football.db datasets, thus, please do NOT edit the JSON files but the source files in the country repos e.g.: