API-FOOTBALL.COM

api documentation

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.rapidapi.com.

API ARCHITECTURE

Here is the graphical representation of the architecture of our API.

authentification

To use our API you must subscribe to one of our pricing plans (we have a FREE PLAN) on rapidapi.com.
For all your requests you must use the access key provided by rapidapi.com (X-RapidAPI-Key).

Requests

Whathever your programming language, our data works with and remain the same across all plateforms.
All requests to the API should be made with the unirest open-source library http://unirest.io.
All requests to the API will send you an answer in JSON format
Here are some examples of API calls.

Curl
curl --get --include 'https://api-football-v1.p.rapidapi.com/seasons' \
   -H 'X-RapidAPI-Key: XXXXXXXXXXXXXXXXXXXXXXXXX' \
   -H 'Accept: application/json'

Java
HttpResponse response = Unirest.get("https://api-football-v1.p.rapidapi.com/seasons")
   .header("X-RapidAPI-Key", "XXXXXXXXXXXXXXXXXXXXXXXXX")
   .header("Accept", "application/json")
   .asJson();

Node
unirest.get("https://api-football-v1.p.rapidapi.com/seasons")
   .header("X-RapidAPI-Key", "XXXXXXXXXXXXXXXXXXXXXXXXX")
   .header("Accept", "application/json")
   .end(function (result) {
      console.log(result.status, result.headers, result.body);
	});

Php
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/seasons",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Python
response = unirest.get("https://api-football-v1.p.rapidapi.com/seasons",
   headers={
      "X-RapidAPI-Key": "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept": "application/json"
   }
)

Objective-c
NSDictionary *headers = @{@"X-RapidAPI-Key": @"XXXXXXXXXXXXXXXXXXXXXXXXX", @"Accept": @"application/json"};
   UNIUrlConnection *asyncConnection = [[UNIRest get:^(UNISimpleRequest *request) {
      [request setUrl:@"https://api-football-v1.p.rapidapi.com/seasons"];
      [request setHeaders:headers];
   }] asJsonAsync:^(UNIHTTPJsonResponse *response, NSError *error) {
      NSInteger code = response.code;
      NSDictionary *responseHeaders = response.headers;
      UNIJsonNode *body = response.body;
      NSData *rawBody = response.rawBody;
	}];

Ruby
response = Unirest.get "https://api-football-v1.p.rapidapi.com/seasons",
   headers:{
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   }

.Net
Task response = Unirest.get("https://api-football-v1.p.rapidapi.com/seasons")
   .header("X-RapidAPI-Key", "XXXXXXXXXXXXXXXXXXXXXXXXX")
   .header("Accept", "application/json")
   .asJson();

Countries

Get all available countries in the API across all seasons and competitions.

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/countries

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

Response body 200 / JSON
{
  "api": {
    "results": 22,
    "countries": {
      "1": "Argentina",
      "2": "Belarus",
      "3": "Belgium",
      "4": "Brazil",
      "5": "Bulgaria",
      "6": "China",
      "7": "Costa Rica",
      "8": "Denmark",
      "9": "England",
      "10": "France",
      "11": "Germany",
      "12": "Iceland",
      "13": "Italy",
      "14": "Japan",
      "15": "Netherlands",
      "16": "Norway",
      "17": "Poland",
      "18": "Portugal",
      "19": "Spain",
      "20": "Sweden",
      "21": "Wales",
      "22": "World"
    }
  }
}

Seasons

Get all available seasons.

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/seasons

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

Response body 200 / JSON
{
  "api": {
    "results": 3,
    "seasons": {
      "1": "2016",
      "2": "2017",
      "3": "2018"
    }
  }
}

Leagues

/leagues

Get all available leagues

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/leagues

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

Response body 200 / JSON
{
  "api": {
    "results": 85,
    "leagues": {
      "1": {
        "league_id": "1",
        "name": "2018 Russia World cup",
        "country": "World",
		"country_code": "",
        "season": "2018",
        "season_start": "2018-06-14",
        "season_end": "2018-07-15",
        "logo": "https://www.api-football.com/public/leagues/1.png",
        "standings": false
      },
      "2": {
        "league_id": "2",
        "name": "Premier League",
        "country": "England",
		"country_code": "GB",
        "season": "2018",
        "season_start": "2018-08-10",
        "season_end": "2019-05-12",
        "logo": "https://www.api-football.com/public/leagues/2.png",
        "standings": true
      },
      "3": {
        "league_id": "3",
        "name": "Championship",
        "country": "England",
		"country_code": "GB",
        "season": "2018",
        "season_start": "2018-08-03",
        "season_end": "2019-05-05",
        "logo": "https://www.api-football.com/public/leagues/3.png",
        "standings": true
      },
      "4": {
        "league_id": "4",
        "name": "Ligue 1",
        "country": "France",
		"country_code": "FR",
        "season": "2018",
        "season_start": "2018-08-11",
        "season_end": "2019-05-25",
        "logo": "https://www.api-football.com/public/leagues/4.svg",
        "standings": true
      },
...



/leagues/league/{league_id}

Get one league from his ID

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/leagues/league/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/leagues/league/5",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "leagues": {
      "5": {
        "league_id": "5",
        "name": "Ligue 2",
        "country": "France",
		"country_code": "FR",
        "season": "2018",
        "season_start": "2018-07-27",
        "season_end": "2019-09-21",
        "logo": "https://www.api-football.com/public/leagues/5.png",
        "standings": true
      }
    }
  }
}



/leagues/season/{season}

Get all leagues from one season

URL Parameters
SEASON
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/leagues/season/{season}

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

Response body 200 / JSON
{
  "api": {
    "results": 29,
    "leagues": {
      "1": {
        "league_id": "1",
        "name": "2018 Russia World Cup",
        "country": "World",
		"country_code": "",
        "season": "2018",
        "season_start": "2018-06-14",
        "season_end": "2018-07-15",
        "logo": "https://www.api-football.com/public/leagues/1.png",
        "standings": false
      },
      "2": {
        "league_id": "2",
        "name": "Premier League",
        "country": "England",
		"country_code": "GB",
        "season": "2018",
        "season_start": "2018-08-10",
        "season_end": "2019-05-12",
        "logo": "https://www.api-football.com/public/leagues/2.png",
        "standings": true
      },
      "3": {
        "league_id": "3",
        "name": "Championship",
        "country": "England",
		"country_code": "GB",
        "season": "2018",
        "season_start": "2018-08-03",
        "season_end": "2019-05-05",
        "logo": "https://www.api-football.com/public/leagues/3.png",
        "standings": true
      },
...



/leagues/country/{country_name}/{season}

Get all leagues from one country or country code (GB, FR, IT etc..) and filter by season. (Filter by season is optional)

URL Parameters
COUNTRY
STRING
SEASON
NUMBER (optional)

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/leagues/country/{country_name}/{season}

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

Response body 200 / JSON
{
  "api": {
    "results": 2,
    "leagues": {
      "4": {
        "league_id": "4",
        "name": "Ligue 1",
        "country": "France",
		"country_code": "FR",
        "season": "2018",
        "season_start": "2018-08-10",
        "season_end": "2019-05-25",
        "logo": "https://www.api-football.com/public/leagues/4.svg",
        "standings": true
      },
      "5": {
        "league_id": "5",
        "name": "Ligue 2",
        "country": "France",
		"country_code": "FR",
        "season": "2018",
        "season_start": "2018-07-27",
        "season_end": "2019-09-21",
        "logo": "https://www.api-football.com/public/leagues/5.png",
        "standings": true
      }
    }
  }
}

Teams

/teams/team/{team_id}

Get one team from his ID

URL Parameters
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/teams/team/{team_id}

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

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "teams": {
      "33": {
        "team_id": "33",
        "name": "Manchester United",
        "logo": "https://www.api-football.com/public/teams/33.png"
      }
    }
  }
}



/teams/league/{league_id}

Get all teams from one league

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/teams/league/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/teams/league/37",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 20,
    "teams": {
      "33": {
        "team_id": "33",
        "name": "Manchester United",
        "logo": "https://www.api-football.com/public/teams/33.png"
      },
      "34": {
        "team_id": "34",
        "name": "Newcastle",
        "logo": "https://www.api-football.com/public/teams/34.png"
      },
      "35": {
        "team_id": "35",
        "name": "Bournemouth",
        "logo": "https://www.api-football.com/public/teams/35.png"
      },
      "37": {
        "team_id": "37",
        "name": "Huddersfield",
        "logo": "https://www.api-football.com/public/teams/37.png"
      },
...

Players

Get coachs and players from one team and season.

URL Parameters
SEASON
NUMBER
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/players/{season}/{team_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/players/2018/33",
   array(
      "X-RapidAPI-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"
      }
    ]
  }
}

Standings

/leagueTable/{league_id}

Get the league table from one league or cup. To be use instead of "standings".
The return is a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, group phase, opening ranking, closing ranking etc...

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/leagueTable/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/leagueTable/132",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "standings": [
      [
        {
          "rank": "1",
          "teamName": "Borussia Dortmund",
          "matchsPlayed": "6",
          "win": "4",
          "draw": "1",
          "lose": "1",
          "goalsFor": "10",
          "goalsAgainst": "2",
          "goalsDiff": "8",
          "points": "13",
          "group": "Group A",
          "lastUpdate": "2018-12-12"
        },
        {
          "rank": "2",
          "teamName": "Atletico Madrid",
          "matchsPlayed": "6",
          "win": "4",
          "draw": "1",
          "lose": "1",
          "goalsFor": "9",
          "goalsAgainst": "6",
          "goalsDiff": "3",
          "points": "13",
          "group": "Group A",
          "lastUpdate": "2018-12-12"
        },
        {
          "rank": "3",
          "teamName": "Club Brugge KV",
          "matchsPlayed": "6",
          "win": "1",
          "draw": "3",
          "lose": "2",
          "goalsFor": "6",
          "goalsAgainst": "5",
          "goalsDiff": "1",
          "points": "6",
          "group": "Group A",
          "lastUpdate": "2018-12-12"
        },
        {
          "rank": "4",
          "teamName": "Monaco",
          "matchsPlayed": "6",
          "win": "0",
          "draw": "1",
          "lose": "5",
          "goalsFor": "2",
          "goalsAgainst": "14",
          "goalsDiff": "-12",
          "points": "1",
          "group": "Group A",
          "lastUpdate": "2018-12-12"
        },
        {
          "rank": "1",
          "teamName": "Barcelona",
          "matchsPlayed": "6",
          "win": "4",
          "draw": "2",
          "lose": "0",
          "goalsFor": "14",
          "goalsAgainst": "5",
          "goalsDiff": "9",
          "points": "14",
          "group": "Group B",
          "lastUpdate": "2018-12-12"
        },
        {...}
      ]
    }
}



/standings/{league_id} DEPRECIATED

THIS ENDPOINT IS DEPRECIATED USE "LEAGUETABLE ENDPOINT" INSTEAD.
Get the league table from one league. Updated every four hours.

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/standings/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/standings/37",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 20,
    "standings": {
      "1": {
        "league_id": "37",
        "team_id": "50",
        "teamName": "Manchester City",
        "play": "38",
        "win": "32",
        "draw": "4",
        "lose": "2",
        "goalsFor": "106",
        "goalsAgainst": "27",
        "goalsDiff": "79",
        "points": "100"
      },
      "2": {
        "league_id": "37",
        "team_id": "33",
        "teamName": "Manchester United",
        "play": "38",
        "win": "25",
        "draw": "6",
        "lose": "7",
        "goalsFor": "68",
        "goalsAgainst": "28",
        "goalsDiff": "40",
        "points": "81"
      },
      "3": {
        "league_id": "37",
        "team_id": "47",
        "teamName": "Tottenham",
        "play": "38",
        "win": "23",
        "draw": "8",
        "lose": "7",
        "goalsFor": "74",
        "goalsAgainst": "36",
        "goalsDiff": "38",
        "points": "77"
      },
      "4": {
        "league_id": "37",
        "team_id": "40",
        "teamName": "Liverpool",
        "play": "38",
        "win": "21",
        "draw": "12",
        "lose": "5",
        "goalsFor": "84",
        "goalsAgainst": "38",
        "goalsDiff": "46",
        "points": "75"
      },
...

Fixtures

/fixtures/live

Get all fixtures in play. Updated every minutes. it can be delayed from 1 to 5 minutes depending on the league/cup.

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/fixtures/live

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/fixtures/live",
  array(
    "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
    "Accept" => "application/json"
  )
);

Response body 200 / JSON
{
  "api": {
    "results": 12,
    "fixtures": {
      "2839": {
        "fixture_id": "2839",
        "event_timestamp": "1534185000",
        "event_date": "2018-08-13T18:30:00+00:00",
        "league_id": "9",
        "round": "2. Bundesliga - 2",
        "homeTeam_id": "192",
        "awayTeam_id": "182",
        "homeTeam": "FC Koln",
        "awayTeam": "Union Berlin",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 0",
        "final_score": "1 - 1",
        "penalty": null,
        "elapsed": "93",
        "firstHalfStart": "1534185060",
        "secondHalfStart": "1534188780"
      },
      "3439": {
        "fixture_id": "3439",
        "event_timestamp": "1534187700",
        "event_date": "2018-08-13T19:15:00+00:00",
        "league_id": "11",
        "round": "Primeira Liga - 1",
        "homeTeam_id": "216",
        "awayTeam_id": "222",
        "homeTeam": "Portimonense",
        "awayTeam": "Boavista",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "2",
        "halftime_score": "0 - 0",
        "final_score": "0 - 2",
        "penalty": null,
        "elapsed": "94",
        "firstHalfStart": "1534187760",
        "secondHalfStart": "1534191480"
      },
      "4951": {
        "fixture_id": "4951",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "15",
        "round": "Eliteserien - 18",
        "homeTeam_id": "328",
        "awayTeam_id": "326",
        "homeTeam": "Haugesund",
        "awayTeam": "Valerenga",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
	  {...}
      }
    }
  }
}



/fixtures/date/{date}

Get all fixtures from one date

URL Parameters
DATE
STRING

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/fixtures/date/{date}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/fixtures/date/2018-07-15",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
	  "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 12,
    "fixtures": {
      "2839": {
        "fixture_id": "2839",
        "event_timestamp": "1534185000",
        "event_date": "2018-08-13T18:30:00+00:00",
        "league_id": "9",
        "round": "2. Bundesliga - 2",
        "homeTeam_id": "192",
        "awayTeam_id": "182",
        "homeTeam": "FC Koln",
        "awayTeam": "Union Berlin",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 0",
        "final_score": "1 - 1",
        "penalty": null,
        "elapsed": "93",
        "firstHalfStart": "1534185060",
        "secondHalfStart": "1534188780"
      },
      "3439": {
        "fixture_id": "3439",
        "event_timestamp": "1534187700",
        "event_date": "2018-08-13T19:15:00+00:00",
        "league_id": "11",
        "round": "Primeira Liga - 1",
        "homeTeam_id": "216",
        "awayTeam_id": "222",
        "homeTeam": "Portimonense",
        "awayTeam": "Boavista",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "2",
        "halftime_score": "0 - 0",
        "final_score": "0 - 2",
        "penalty": null,
        "elapsed": "94",
        "firstHalfStart": "1534187760",
        "secondHalfStart": "1534191480"
      },
      "4951": {
        "fixture_id": "4951",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "15",
        "round": "Eliteserien - 18",
        "homeTeam_id": "328",
        "awayTeam_id": "326",
        "homeTeam": "Haugesund",
        "awayTeam": "Valerenga",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
      "5085": {
        "fixture_id": "5085",
        "event_timestamp": "1534176000",
        "event_date": "2018-08-13T16:00:00+00:00",
        "league_id": "16",
        "round": "Ekstraklasa - 4",
        "homeTeam_id": "346",
        "awayTeam_id": "337",
        "homeTeam": "Korona Kielce",
        "awayTeam": "Slask Wroclaw",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "2",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 1",
        "final_score": "2 - 1",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1534176060",
        "secondHalfStart": "1534179780"
      },
      "5558": {
        "fixture_id": "5558",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "18",
        "round": "Allsvenskan - 17",
        "homeTeam_id": "378",
        "awayTeam_id": "363",
        "homeTeam": "IFK Norrkoping",
        "awayTeam": "Hammarby FF",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "0 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
      "5561": {
        "fixture_id": "5561",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "18",
        "round": "Allsvenskan - 17",
        "homeTeam_id": "369",
        "awayTeam_id": "373",
        "homeTeam": "trelleborgs FF",
        "awayTeam": "GIF Sundsvall",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "6",
        "halftime_score": "1 - 3",
        "final_score": "1 - 6",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
      "5940": {
        "fixture_id": "5940",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "20",
        "round": "Superligaen - 5",
        "homeTeam_id": "403",
        "awayTeam_id": "396",
        "homeTeam": "Esbjerg",
        "awayTeam": "Sonderjyske",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "94",
        "firstHalfStart": "1534179660",
        "secondHalfStart": "1534183380"
      },
	  {...}
    }
  }
}



/fixtures/id/{fixture_id}

Get one fixture from his ID

URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/fixtures/id/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/fixtures/id/65",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "fixtures": {
      "65": {
        "fixture_id": "65",
        "event_timestamp": "1533927600",
        "event_date": "2018-08-10T19:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 1",
        "homeTeam_id": "33",
        "awayTeam_id": "46",
        "homeTeam": "Manchester United",
        "awayTeam": "Leicester",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "2",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 0",
        "final_score": "2 - 1",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1533927660",
        "secondHalfStart": "1533931380"
      }
    }
  }
}



/fixtures/league/{league_id}

Get all fixtures from one league

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/fixtures/league/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/fixtures/league/5",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 380,
    "fixtures": {
      "1377": {
        "fixture_id": "1377",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "98",
        "awayTeam_id": "110",
        "homeTeam": "Ajaccio",
        "awayTeam": "Estac Troyes",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "1",
        "halftime_score": "0 - 1",
        "final_score": "0 - 1",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
      "1378": {
        "fixture_id": "1378",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "99",
        "awayTeam_id": "107",
        "homeTeam": "Clermont Foot",
        "awayTeam": "Chateauroux",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "0 - 0",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
      "1379": {
        "fixture_id": "1379",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "100",
        "awayTeam_id": "114",
        "homeTeam": "Gazelec FC Ajaccio",
        "awayTeam": "Paris FC",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "1",
        "halftime_score": "0 - 1",
        "final_score": "1 - 1",
        "penalty": null,
        "elapsed": "110",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
      "1380": {
        "fixture_id": "1380",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "101",
        "awayTeam_id": "115",
        "homeTeam": "Grenoble",
        "awayTeam": "Sochaux",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "115",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
	  {...}
    }
  }
}



/fixtures/h2h/{team_1}/{team_2}

Get all Head 2 Heads between 2 teams

URL Parameters
TEAM_ID
NUMBER
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/fixtures/h2H/{team_1}/{team_2}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/fixtures/h2h/33/34",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
	  "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 4,
    "fixtures": {
      "141": {
        "fixture_id": "141",
        "event_timestamp": "1538834400",
        "event_date": "2018-10-06T14:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 8",
        "homeTeam_id": "33",
        "awayTeam_id": "34",
        "homeTeam": "Manchester United",
        "awayTeam": "Newcastle",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "272": {
        "fixture_id": "272",
        "event_timestamp": "1546358400",
        "event_date": "2019-01-01T16:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 21",
        "homeTeam_id": "34",
        "awayTeam_id": "33",
        "homeTeam": "Newcastle",
        "awayTeam": "Manchester United",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "11644": {
        "fixture_id": "11644",
        "event_timestamp": "1518362100",
        "event_date": "2018-02-11T15:15:00+00:00",
        "league_id": "37",
        "round": "Premier League - 27",
        "homeTeam_id": "34",
        "awayTeam_id": "33",
        "homeTeam": "Newcastle",
        "awayTeam": "Manchester United",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1518362100",
        "secondHalfStart": "1518365700"
      },
      "11794": {
        "fixture_id": "11794",
        "event_timestamp": "1511029800",
        "event_date": "2017-11-18T18:30:00+00:00",
        "league_id": "37",
        "round": "Premier League - 12",
        "homeTeam_id": "33",
        "awayTeam_id": "34",
        "homeTeam": "Manchester United",
        "awayTeam": "Newcastle",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "4",
        "goalsAwayTeam": "1",
        "halftime_score": "2 - 1",
        "final_score": "4 - 1",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1511029800",
        "secondHalfStart": "1511033400"
      }
    }
  }
}



/fixtures/team/{team_id}

Get all fixtures from one team

URL Parameters
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/fixtures/team/{team_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/fixtures/team/52",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 114,
    "fixtures": {
      "68": {
        "fixture_id": "68",
        "event_timestamp": "1533996000",
        "event_date": "2018-08-11T14:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 1",
        "homeTeam_id": "36",
        "awayTeam_id": "52",
        "homeTeam": "Fulham",
        "awayTeam": "Crystal Palace",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "2",
        "halftime_score": "0 - 1",
        "final_score": "0 - 2",
        "penalty": null,
        "elapsed": "93",
        "firstHalfStart": "1533996060",
        "secondHalfStart": "1533999780"
      },
      "84": {
        "fixture_id": "84",
        "event_timestamp": "1534791600",
        "event_date": "2018-08-20T19:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 2",
        "homeTeam_id": "52",
        "awayTeam_id": "40",
        "homeTeam": "Crystal Palace",
        "awayTeam": "Liverpool",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "92": {
        "fixture_id": "92",
        "event_timestamp": "1535286600",
        "event_date": "2018-08-26T12:30:00+00:00",
        "league_id": "2",
        "round": "Premier League - 3",
        "homeTeam_id": "38",
        "awayTeam_id": "52",
        "homeTeam": "Watford",
        "awayTeam": "Crystal Palace",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "99": {
        "fixture_id": "99",
        "event_timestamp": "1535810400",
        "event_date": "2018-09-01T14:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 4",
        "homeTeam_id": "52",
        "awayTeam_id": "41",
        "homeTeam": "Crystal Palace",
        "awayTeam": "Southampton",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
	  {...}
    }
  }
}

Events

Get all events from one fixture.

Match events are updated at half-time and at the end of the match.

URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/events/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/events/37509",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 10,
    "events": [
      {
        "elapsed": "12",
        "teamName": "Parana",
        "player": "Richard",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "14",
        "teamName": "Atletico mg",
        "player": "Fabio Santos",
        "type": "Goal",
        "detail": "Penalty"
      },
      {
        "elapsed": "18",
        "teamName": "Parana",
        "player": "Andrey",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "29",
        "teamName": "Parana",
        "player": "Silvinho",
        "type": "Card",
        "detail": "Red Card"
      },
      {
        "elapsed": "35",
        "teamName": "Atletico mg",
        "player": "Emerson Junior",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "45",
        "teamName": "Parana",
        "player": "Alex Santana",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "48",
        "teamName": "Parana",
        "player": "Andrey",
        "type": "Card",
        "detail": "Second Yellow Card"
      },
      {
        "elapsed": "49",
        "teamName": "Atletico mg",
        "player": "Bruno Roberto",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "52",
        "teamName": "Atletico mg",
        "player": "Patric",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "62",
        "teamName": "Parana",
        "player": "Charles",
        "type": "Card",
        "detail": "Yellow Card"
      }
    ]
  }
}

Line Ups

Get all line ups from one fixture.

  • Formation
  • Coach
  • Start XI
  • Substitutes
URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/lineups/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/lineups/40697",
   array(
      "X-RapidAPI-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"
          }
        ]
      }
    }
  }
}

Odds

Get all pre-match odds from one fixture. We provide pre-match odds between 1 and 15 days before the match. (Some competitions do not have this feature).

URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/odds/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/odds/123",
   array(
      "X-RapidAPI-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
	  "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 29,
    "odds": {
      "Win the match": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "1.83"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "5.00"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "3.25"
        }
      },
      "Handicap [0:3]": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "14.00"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "1.01"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "7.00"
        }
      },
      "Half Time": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "2.35"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "4.50"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "1.80"
        }
      },
      "Exact score": {
        "1 - 0": {
          "label": "1 - 0",
          "pos": "1",
          "odd": "4.60"
        },
        "2 - 0": {
          "label": "2 - 0",
          "pos": "2",
          "odd": "6.50"
        },
        "2 - 1": {
          "label": "2 - 1",
          "pos": "3",
          "odd": "9.00"
        }
		{...}
      },
      "Double chance": {
        "1/N": {
          "label": "1/N",
          "pos": "1",
          "odd": "1.11"
        },
        "N/2": {
          "label": "N/2",
          "pos": "2",
          "odd": "1.88"
        },
        "1/2": {
          "label": "1/2",
          "pos": "3",
          "odd": "1.28"
        }
      },
      "Result & The 2 teams score": {
        "France / Yes": {
          "label": "France / Yes",
          "pos": "1",
          "odd": "4.45"
        },
        "France / No": {
          "label": "France / No",
          "pos": "2",
          "odd": "2.20"
        },
        "N / Yes": {
          "label": "N / Yes",
          "pos": "3",
          "odd": "4.20"
        },
        "N / No": {
          "label": "N / No",
          "pos": "4",
          "odd": "5.25"
        },
        "Croatie / Yes": {
          "label": "Croatie / Yes",
          "pos": "5",
          "odd": "10.00"
        },
        "Croatie / No": {
          "label": "Croatie / No",
          "pos": "6",
          "odd": "5.25"
        }
      },
      "Both teams score": {
        "Yes": {
          "label": "Yes",
          "pos": "1",
          "odd": "2.05"
        },
        "No": {
          "label": "No",
          "pos": "2",
          "odd": "1.45"
        }
      },
      "Over / Under 4.5 goals (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "6.00"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.01"
        }
      },
      "Over / Under 3.5 goals (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "3.70"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.10"
        }
      },
      "Over / Under 2.5 goals (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "2.30"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.35"
        }
      },
      "Over / Under 1.5 goal (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "1.42"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "2.10"
        }
      },
      "Scorer (90 Mins)": {
        "A.Griezmann": {
          "label": "A.Griezmann",
          "pos": "1",
          "odd": "2.60"
        },
        "A.Griezmann & L.Modric": {
          "label": "A.Griezmann & L.Modric",
          "pos": "2",
          "odd": "13.00"
        },
        "A.Griezmann & O.Girord": {
          "label": "A.Griezmann & O.Girord",
          "pos": "3",
          "odd": "8.50"
        },
        "A.Griezmann (2 or +)": {
          "label": "A.Griezmann (2 or +)",
          "pos": "4",
          "odd": "9.00"
        },
		{...}
      },
      "1st Goal scorer (90 Mins)": {
        "A.Griezmann": {
          "label": "A.Griezmann",
          "pos": "1",
          "odd": "5.00"
        },
        "B.Matuidi": {
          "label": "B.Matuidi",
          "pos": "2",
          "odd": "15.00"
        },
		{...}
      },
      "Face to Face": {
        "France": {
          "label": "France",
          "pos": "1",
          "odd": "1.28"
        },
        "Croatie": {
          "label": "Croatie",
          "pos": "2",
          "odd": "2.55"
        }
      },
      "1st goal": {
        "Team 1": {
          "label": "Team 1",
          "pos": "1",
          "odd": "1.50"
        },
        "Team 2": {
          "label": "Team 2",
          "pos": "2",
          "odd": "2.65"
        },
        "No goal": {
          "label": "No goal",
          "pos": "3",
          "odd": "6.50"
        }
      },
      "HT/FT": {
        "1/1": {
          "label": "1/1",
          "pos": "1",
          "odd": "2.65"
        },
        "1/N": {
          "label": "1/N",
          "pos": "2",
          "odd": "14.50"
        },
        "1/2": {
          "label": "1/2",
          "pos": "3",
          "odd": "30.00"
        },
        "N/1": {
          "label": "N/1",
          "pos": "4",
          "odd": "3.90"
        },
        "N/N": {
          "label": "N/N",
          "pos": "5",
          "odd": "4.00"
        },
        "N/2": {
          "label": "N/2",
          "pos": "6",
          "odd": "8.50"
        },
        "2/1": {
          "label": "2/1",
          "pos": "7",
          "odd": "22.00"
        },
        "2/N": {
          "label": "2/N",
          "pos": "8",
          "odd": "15.00"
        },
        "2/2": {
          "label": "2/2",
          "pos": "9",
          "odd": "7.50"
        }
      },
      "Result & Over/Under": {
        "France & over 3,5": {
          "label": "France & over 3,5",
          "pos": "1",
          "odd": "6.00"
        },
        "Draw & over 3,5": {
          "label": "Draw & over 3,5",
          "pos": "2",
          "odd": "11.00"
        },
        "Croatie & over 3,5": {
          "label": "Croatie & over 3,5",
          "pos": "3",
          "odd": "18.50"
        },
        "France & under 3,5": {
          "label": "France & under 3,5",
          "pos": "4",
          "odd": "2.00"
        },
        "Draw & under 3,5": {
          "label": "Draw & under 3,5",
          "pos": "5",
          "odd": "3.30"
        },
        "Croatie & under 3,5": {
          "label": "Croatie & under 3,5",
          "pos": "6",
          "odd": "5.00"
        },
        "France & over 1,5": {
          "label": "France & over 1,5",
          "pos": "1",
          "odd": "2.45"
        },
        "Draw & over 1,5": {
          "label": "Draw & over 1,5",
          "pos": "2",
          "odd": "3.65"
        },
        "Croatie & over 1,5": {
          "label": "Croatie & over 1,5",
          "pos": "3",
          "odd": "7.00"
        },
        "France & under 1,5": {
          "label": "France & under 1,5",
          "pos": "4",
          "odd": "4.70"
        },
        "Draw & under 1,5": {
          "label": "Draw & under 1,5",
          "pos": "5",
          "odd": "6.50"
        },
        "Croatie & under 1,5": {
          "label": "Croatie & under 1,5",
          "pos": "6",
          "odd": "8.50"
        },
        "France & over 2,5": {
          "label": "France & over 2,5",
          "pos": "1",
          "odd": "3.75"
        },
        "Draw & over 2,5": {
          "label": "Draw & over 2,5",
          "pos": "2",
          "odd": "11.00"
        },
        "Croatie & over 2,5": {
          "label": "Croatie & over 2,5",
          "pos": "3",
          "odd": "10.00"
        },
        "France & under 2,5": {
          "label": "France & under 2,5",
          "pos": "4",
          "odd": "2.60"
        },
        "Draw & under 2,5": {
          "label": "Draw & under 2,5",
          "pos": "5",
          "odd": "3.50"
        },
        "Croatie & under 2,5": {
          "label": "Croatie & under 2,5",
          "pos": "6",
          "odd": "6.25"
        },
        "France & over 4,5": {
          "label": "France & over 4,5",
          "pos": "1",
          "odd": "8.25"
        },
        "Draw & over 4,5": {
          "label": "Draw & over 4,5",
          "pos": "2",
          "odd": "19.50"
        },
        "Croatie & over 4,5": {
          "label": "Croatie & over 4,5",
          "pos": "3",
          "odd": "25.00"
        },
        "France & under 4,5": {
          "label": "France & under 4,5",
          "pos": "4",
          "odd": "1.85"
        },
        "Draw & under 4,5": {
          "label": "Draw & under 4,5",
          "pos": "5",
          "odd": "3.25"
        },
        "Croatie & under 4,5": {
          "label": "Croatie & under 4,5",
          "pos": "6",
          "odd": "5.00"
        }
      },
      "Double Chance HT": {
        "1/N": {
          "label": "1/N",
          "pos": "1",
          "odd": "1.10"
        },
        "N/2": {
          "label": "N/2",
          "pos": "2",
          "odd": "1.40"
        },
        "1/2": {
          "label": "1/2",
          "pos": "3",
          "odd": "1.68"
        }
      },
      "Exact Score HT": {
        "1 - 0": {
          "label": "1 - 0",
          "pos": "1",
          "odd": "3.15"
        },
        "2 - 0": {
          "label": "2 - 0",
          "pos": "2",
          "odd": "10.50"
        },
		{...}
      },
      "Over/Under HT 0.5 goal": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "1.45"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "2.05"
        }
      },
      "Over/Under MT 2,5 goals": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "5.50"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.01"
        }
      },
      "Over/Under HT 1.5 goal": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "3.00"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.19"
        }
      },
      "Both teams score HT": {
        "Yes": {
          "label": "Yes",
          "pos": "1",
          "odd": "4.20"
        },
        "No": {
          "label": "No",
          "pos": "2",
          "odd": "1.06"
        }
      },
      "1N2_2eMT": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "2.10"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "4.20"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "2.05"
        }
      }
    }
  }
}

Statistics

Get team statistics for a one league/cup. You can pass the date if you want to add a limit.

URL Parameters
LEAGUE_ID
NUMBER
TEAM_ID
NUMBER
DATE
STRING (optional)

Endoint Definition
Test this https://api-football-v1.p.rapidapi.com/statistics/{league_id}/{team_id}/{date}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.rapidapi.com/statistics/22/77/2019-02-16",
   array(
      "X-RapidAPI-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"
        }
      }
    }
  }
}