API-FOOTBALL.COM

api news

World Cup Women
World Cup Women have just been added to our API.
  • France 2019
  • Canada 2015
  • Germany 2011
Italy Serie C
Hello again,

here is the second addition of the day: Italy Serie C.

What will be the next league, we will see soon.
feminine division 1
Hi everyone,

We just added 3 seasons of the French Feminine Division 1 to our api. (2016 to 2019).

Have a lovely day everybody !
COACHS & PLAYERS
Good news !

We have just added the endpoint "Players" which allows you to recover the coachs and the players of a team according to the season and the id of the team.

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/players/2018/33",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 28,
    "coachs": [
      "Jose Mourinho"
    ],
    "players": [
      {
        "number": "",
        "player": "David De Gea"
      },
      {
        "number": "",
        "player": "Victor Nilsson-Lindelof"
      },
      {
        "number": "",
        "player": "Chris Smalling"
      },
      {
        "number": "",
        "player": "Ashley Young"
      },
      {
        "number": "",
        "player": "Matteo Darmian"
      },
      {
        "number": "",
        "player": "Paul Pogba"
      },
      {
        "number": "",
        "player": "Juan Mata"
      },
      {
        "number": "",
        "player": "Anthony Martial"
      },
      {
        "number": "",
        "player": "Jesse Lingard"
      },
      {
        "number": "",
        "player": "Nemanja Matic"
      },
      {
        "number": "",
        "player": "Romelu Lukaku"
      },
      {
        "number": "",
        "player": "Phil Jones"
      },
      {
        "number": "",
        "player": "Alexis Sanchez"
      },
      {
        "number": "",
        "player": "Marcus Rashford"
      },
      {
        "number": "",
        "player": "Lee Grant"
      },
      {
        "number": "",
        "player": "Fred"
      },
      {
        "number": "",
        "player": "Antonio Valencia"
      },
      {
        "number": "",
        "player": "Marouane Fellaini"
      },
      {
        "number": "",
        "player": "Luke Shaw"
      },
      {
        "number": "",
        "player": "Eric Bailly"
      },
      {
        "number": "",
        "player": "Andreas Pereira"
      },
      {
        "number": "",
        "player": "Sergio Romero"
      },
      {
        "number": "",
        "player": "Scott McTominay"
      },
      {
        "number": "39",
        "player": "Scott Mctominay"
      },
      {
        "number": "21",
        "player": "Ander Herrera"
      },
      {
        "number": "5",
        "player": "Faustino Marcos Alberto Rojo"
      },
      {
        "number": "20",
        "player": "Diogo Dalot"
      }
    ]
  }
}
DFB POKAL
The DFB POKAL is now available in our API.
  • Season 2018
  • Season 2017
  • Season 2016
Hope you like it !
USA MLS
The USA Major Soccer League is available in the API.
  • Season 2018
  • Season 2017
  • Season 2016
Enjoy !
ASIAN CUP
Whe add just add the Asian Cup into the API.
  • Asian Cup UAE 2019
  • Asian Cup Australia 2015
  • Asian Cup Qatar 2011
LINE UPS
Good New Line Ups are available,
  • Formation
  • Coach
  • Start XI
  • Substitutes
Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/lineups/{fixture_id}",
  array(
    "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
    "Accept" => "application/json"
  )
);

Response body 200 / JSON
{
  "api": {
    "results": 2,
    "lineUps": {
      "germany": {
        "formation": "3-4-3",
        "coach": "Joachim Loew",
        "startXI": [
          {
            "number": "",
            "player": "Manuel Neuer"
          },
          {
            "number": "",
            "player": "Mats Hummels"
          },
          {
            "number": "",
            "player": "Niklas Suele"
          },
          {
            "number": "",
            "player": "Antonio Rudiger"
          },
          {
            "number": "",
            "player": "Thilo Kehrer"
          },
          {
            "number": "",
            "player": "Toni Kroos"
          },
          {
            "number": "",
            "player": "Nico Schulz"
          },
          {
            "number": "",
            "player": "Joshua Kimmich"
          },
          {
            "number": "",
            "player": "Timo Werner"
          },
          {
            "number": "",
            "player": "Leroy Sane"
          },
          {
            "number": "",
            "player": "Serge Gnabry"
          }
        ],
        "substitutes": [
          {
            "number": "",
            "player": "Jonas Hector"
          },
          {
            "number": "",
            "player": "Matthias Ginter"
          },
          {
            "number": "",
            "player": "Leon Goretzka"
          },
          {
            "number": "",
            "player": "Julian Brandt"
          },
          {
            "number": "",
            "player": "Marco Reus"
          },
          {
            "number": "",
            "player": "Bernd Leno"
          },
          {
            "number": "",
            "player": "Thomas Mueller"
          }
        ]
      },
      "netherlands": {
        "formation": "4-3-3",
        "coach": "Ronald Koeman",
        "startXI": [
          {
            "number": "1",
            "player": "Jasper Cillessen"
          },
          {
            "number": "",
            "player": "Kenny Tete"
          },
          {
            "number": "",
            "player": "Matthijs De Ligt"
          },
          {
            "number": "",
            "player": "Virgil Van Dijk"
          },
          {
            "number": "5",
            "player": "Daley Blind"
          },
          {
            "number": "",
            "player": "Marten De Roon"
          },
          {
            "number": "",
            "player": "Frenkie De Jong"
          },
          {
            "number": "20",
            "player": "Georginio Wijnaldum"
          },
          {
            "number": "",
            "player": "Quincy Promes"
          },
          {
            "number": "21",
            "player": "Memphis Depay"
          },
          {
            "number": "",
            "player": "Ryan Babel"
          }
        ],
        "substitutes": [
          {
            "number": "",
            "player": "Denzel Dumfries"
          },
          {
            "number": "",
            "player": "Jeroen Zoet"
          },
          {
            "number": "3",
            "player": "Stefan De Vrij"
          },
          {
            "number": "",
            "player": "Nathan Ake"
          },
          {
            "number": "17",
            "player": "Kevin Strootman"
          },
          {
            "number": "",
            "player": "Donny Van De Beek"
          },
          {
            "number": "",
            "player": "Pablo Paulino Rosario"
          }
        ]
      }
    }
  }
}
Africa Cup Of Nations
Hi everyone,
We have add the Africa Cup Of Nations in the API
  • Cameroon 2019
  • Gabon 2017
  • Equitorial Guinea 2015
NPL - Primera B - Druga HNL
Hi everyone,
We have add in the API :
  • Australia National Premier Leagues
  • Colombia Primera B
  • Croatia Druga HNL
Have a good day :-)
2e Klasse - Erste Liga - League One - B PFG
We have just add theses four new leagues in our API.
  • Belgium 2e Klasse
  • Austria Erste Liga
  • China League One
  • Bulgaria B PFG
SCOTLAND CHAMPIONSHIP
Scotland Championship is available, we have just add three seasons.
SEASONS :
  • 2018-2019
  • 2017-2018
  • 2016-2017
LEAGUES ENGLAND
Hi everyone,
We have just add two new leagues in the API.
  • ENGLAND - LEAGUE ONE
  • ENGLAND - LEAGUE TWO
NBA API
Hello sports fan,

Today we announce the launch of our new API: API-NBA !
All NBA DATA, Games, Livescore, Standings, Statistics, Teams, Players, Seasons, Leagues.
Hoping that you will like it as much as api-football.

Here the link to the API https://market.mashape.com/api-sports/api-nba/
GERMANY LIGA 3
We have just implemented the Germany Liga 3 in the API. ENJOY !

  • 2018 - 2019
  • 2017 - 2018
  • 2016 - 2017
FRANCE NATIONAL
France National is now available !

  • 2018 - 2019
  • 2017 - 2018
  • 2016 - 2017
KNVB BEKER
KNVB BEKER CUP is now available !

  • 2018 - 2019
  • 2017 - 2018
  • 2016 - 2017
COPA DO BRASIL
Copa Do Brasil is available !

  • Season 2018 - 2019
  • Season 2017 - 2018
  • Season 2016 - 2017
API DEMO
A demo version of the API is available at this url : https://www.api-football.com/demo.

Here are the leagues present in the demo version :
  • 2018 Russia World Cup
  • Champions League (2016-2017)
  • Brazil - Serie A (2016-2017-2018)
  • England - Premier League (2016-2017-2018)
  • Netherlands - Eredivisie (2016-2017-2018)
You can use it without restriction in your development environment.

This is a demo and does not represent the entire API. The data is limited and not up to date and serves only as an example. For production environement use : https://api-football-v1.p.mashape.com.
paraguay, primera division
We have just added 3 seasons of the Paraguay Primera Division in the API.

  • Season 2018 - 2019
  • Season 2017 - 2018
  • Season 2016 - 2017
FINLAND, Veikkausliiga
Finland Veikkausliiga is now available !

  • Season 2018 - 2019
  • Season 2017 - 2018
  • Season 2016 - 2017
COLOMBIA, ECUADOR, GREECE
3 new competitions in the API !

  • COLOMBIA - PRIMERA A
  • ECUADOR - CAMPEONATO SERIE A
  • GREECE - SUPER LEAGUE
UEFA NATIONS LEAGUE
We have just implemented the UEFA NATIONS LEAGUE in the API.
ENJOY !
RUSSIA PREMIER LEAGUE
He have just added the Russia Premier League in our API :-)

  • Season 2018-2019
  • Season 2017-2018
  • Season 2016-2017
UEFA CHAMPION LEAGUE 2018/2019
UEFA Champion League 2018 is available

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/leagues/league/132",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);
4 new leagues for 2018/2019
He have just added 4 leagues for the 2018/19 season !

  • Argentina - Primeira B Nationnal
  • Croatia - Prva HNL
  • Italy - Serie B
  • Switzerland - Super League
FIVE OTHER COMPETITIONS
And we add 5 new competitions to our API

  • Austria - Tipp3 Bundesliga
  • Croatia - Prva HNL
  • Egypt - Premier League
  • Honduras - Liga Nacional de Fútbol
  • Switzerland - Super League
THREE NEW LEAGUES IN OUR API (Morocco, Tunisia, Turkey)
3 new leagues available tonight

  • Morocco
    • Botola Pro 2017/2018
    • Botola Pro 2016/2017
  • Tunisia
    • Ligue Professionnelle 1 2017/2018
    • Ligue Professionnelle 1 2016/2017
  • Turkey
    • Super Lig 2018/2019
    • Super Lig 2017/2018
    • Super Lig 2016/2017
GREECE SUPER LEAGUE
The Super-League of greece arrives at api-football

  • Seasons available
    • Super-League 2018/2019
    • Super-League 2017/2018
    • Super-League 2016/2017
AUSTRALIA A-LEAGUE IS HERE
New league available : AUSTRALIA A-LEAGUE ! ENJOY !

  • AUSTRALIA
    • A-League 2018/2019
    • A-League 2017/2018
    • A-League 2016/2017
New Leagues (ALGERIA L1 & L2)
We are proud to announce that new competitions are available :

  • ALGERIA
    • Ligue 1 2016/2017
    • Ligue 1 2017/2018
    • Ligue 2 2016/2017
    • Ligue 2 2017/2018
Italy Série A 2018/2019 is available
New league for the 2018/2019 season: Italy Série A.

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/leagues/league/94",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);
new feature : Filter by countries and seasons
New filter for leagues endpoint. Now you can filter leagues by countries and seasons.

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/leagues/country/france/2018",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 2,
    "leagues": {
      "4": {
        "league_id": "4",
        "name": "Ligue 1",
        "country": "France",
        "season": "2018",
        "season_start": "2018-08-10",
        "season_end": "2019-05-25",
        "logo": "https://www.api-football.fr/public/leagues/4.svg",
        "standings": true
      },
      "5": {
        "league_id": "5",
        "name": "Ligue 2",
        "country": "France",
        "season": "2018",
        "season_start": "2018-07-27",
        "season_end": "2019-09-21",
        "logo": "https://www.api-football.fr/public/leagues/5.png",
        "standings": true
      }
    }
  }
}
New Leagues/cup
We are proud to announce that new competitions are available :

  • ITALY
    • Coppa Italia 2017
    • Coppa Italia 2016
  • SCOTLAND
    • Premiership 2018/2019
    • Premiership 2017/2018
    • Premiership 2016/2017
  • SPAIN
    • Primera Division 2018/2019
    • Segunda Division 2018/2019
new feature : statistics
We have implemented a new endpoint "statistics" it gives all the statistics of a team on a competition.

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/statistics/22/77",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "stats": {
      "matchs": {
        "matchsPlayed": {
          "home": 19,
          "away": 19,
          "total": 38
        },
        "wins": {
          "home": 5,
          "away": 4,
          "total": 9
        },
        "draws": {
          "home": 7,
          "away": 7,
          "total": 14
        },
        "loses": {
          "home": 7,
          "away": 8,
          "total": 15
        }
      },
      "goals": {
        "goalsFor": {
          "home": 23,
          "away": 19,
          "total": 42
        },
        "goalsAgainst": {
          "home": 28,
          "away": 24,
          "total": 52
        }
      },
      "goalsAvg": {
        "goalsFor": {
          "home": "1.2",
          "away": "1.0",
          "total": "1.1"
        },
        "goalsAgainst": {
          "home": "1.5",
          "away": "1.3",
          "total": "1.4"
        }
      }
    }
  }
}
List of all available league/cup
We work hard every day to add new competitions. Do not hesitate to ask us for new ones, it's free!

2018/2019
  • Argentina
    • Primera Division
  • Brazil
    • Serie A
    • Serie B
  • Belarus
    • Vyscha Liga
  • Belgium
    • Jupiler Pro League
  • Bulgaria
    • A PFG
  • China
    • Super League
  • Costa Rica
    • Primera Division
  • Denmark
    • Superligaen
  • England
    • Premier League
    • Championship
  • France
    • Ligue 1
    • Ligue 2
  • Germany
    • Bundesliga 1
    • Bundesliga 2
  • Iceland
    • Premier
  • Japan
    • J. League Div.1
    • J. League Div.2
  • Netherlands
    • Eredivisie
    • Eerste Divisie
  • Norway
    • Eliteserien
  • Poland
    • Ekstraklasa
  • Portugal
    • Primeira Liga
    • Liga de Honra
  • Scotland
    • Premiership
  • Spain
    • Primera Division
    • Segunda Division
  • Sweden
    • Allsvenskan
  • Wales
    • Premier
  • World
    • 2018 Russia World Cup

2017/2018
  • Argentina
    • Primera Division
    • Primera B Nacional
  • Brazil
    • Serie A
    • Serie B
  • Belarus
    • Vyscha Liga
  • Belgium
    • Jupiler Pro League
  • China
    • Super League
  • Costa Rica
    • Primera Division
  • England
    • Premier League
    • Championship
  • France
    • Ligue 1
    • Ligue 2
  • Germany
    • Bundesliga 1
    • Bundesliga 2
  • Iceland
    • Premier
  • Italy
    • Serie A
    • Serie B
    • Coppa Italia
  • Japan
    • J. League Div.1
    • J. League Div.2
  • Netherlands
    • Eredivisie
    • Eerste Divisie
  • Norway
    • Eliteserien
  • Portugal
    • Primeira Liga
    • Liga de Honra
  • Scotland
    • Premiership
  • Spain
    • Primera Division
    • Segunda Division
  • Sweden
    • Allsvenskan
  • World
    • Champions League
    • Europa League

2016/2017
  • Argentina
    • Primera Division
    • Primera B Nacional
  • Brazil
    • Serie A
    • Serie B
  • Belarus
    • Vyscha Liga
  • Belgium
    • Jupiler Pro League
  • China
    • Super League
  • Costa Rica
    • Primera Division
  • England
    • Premier League
    • Championship
  • France
    • Ligue 1
    • Ligue 2
  • Germany
    • Bundesliga 1
    • Bundesliga 2
  • Iceland
    • Premier
  • Italy
    • Serie A
    • Serie B
    • Coppa Italia
  • Japan
    • J. League Div.1
    • J. League Div.2
  • Netherlands
    • Eredivisie
    • Eerste Divisie
  • Norway
    • Eliteserien
  • Portugal
    • Primeira Liga
    • Liga de Honra
  • Scotland
    • Premiership
  • Spain
    • Primera Division
    • Segunda Division
  • Sweden
    • Allsvenskan
  • World
    • Euro Championship
    • Champions League
    • Europa League
List of all available endpoints
here is the list of all our available endpoints.
  • Countries
  • Seasons
  • Leagues
  • Teams
  • Standings
  • Fixtures
  • Events
  • Odds
Here We go
After several months of development, we are proud to announce the arrival of our API dedicated to the world of football.