API-FOOTBALL.COM

api news

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.