Countries
Method
GET apifootball.com/api/?action=get_countries
Returns list of supported countries included in your current subscription plan
Parameters
| Parameter | Description |
|---|---|
| action | API method name |
| APIkey | Authorization code generated from your apifootball account |
Request URL
https://apifootball.com/api/?action=get_countries&APIkey=xxxxxxxxxxxxxx
JSON Response
[
{
"country_id":"169",
"country_name":"England"
},
{
"country_id":"170",
"country_name":"Italy"
},
{
"country_id":"171",
"country_name":"Spain"
},
{
"country_id":"172",
"country_name":"Germany"
},
{
"country_id":"173",
"country_name":"France"
},
{
"country_id":"174",
"country_name":"Netherlands"
},
{
"country_id":"175",
"country_name":"Belgium"
},
{
"country_id":"176",
"country_name":"Portugal"
},
{
"country_id":"177",
"country_name":"Scotland"
},
....
]
PHP call example
$APIkey='xxxxxxxxxxxxxx';
$curl_options = array(
CURLOPT_URL => "https://apifootball.com/api/?action=get_countries&APIkey=$APIkey",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 5
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
$result = (array) json_decode($result);
var_dump($result);
Competitions
Method
GET apifootball.com/api/?action=get_leagues
Returns list of supported competitions included in your current subscription plan
Parameters
| Parameter | Description |
|---|---|
| action | API method name |
| APIkey | Authorization code generated from your apifootball account |
| country_id | Country ID - if set only leagues from specific country will be returned (Optional) |
Request URL
https://apifootball.com/api/?action=get_leagues&country_id=169&APIkey=xxxxxxxxxxxxxx
JSON Response
[
{
"country_id":"169",
"country_name":"England",
"league_id":"62",
"league_name":"Premier League"
},
{
"country_id":"169",
"country_name":"England",
"league_id":"65",
"league_name":"League 2"
},
{
"country_id":"169",
"country_name":"England",
"league_id":"66",
"league_name":"Nat. League"
},
{
"country_id":"169",
"country_name":"England",
"league_id":"67",
"league_name":"Nat. League North"
},
{
"country_id":"169",
"country_name":"England",
"league_id":"68",
"league_name":"Nat. League South"
},
{
"country_id":"169",
"country_name":"England",
"league_id":"69",
"league_name":"FA Cup"
},
{
"country_id":"169",
"country_name":"England",
"league_id":"70",
"league_name":"Capital One Cup"
},
{
"country_id":"169",
"country_name":"England",
"league_id":"71",
"league_name":"Community Shield"
},
....
]
PHP call example
$APIkey='xxxxxxxxxxxxxx';
$country_id = 169;
$curl_options = array(
CURLOPT_URL => "https://apifootball.com/api/?action=get_leagues&country_id=$country_id&APIkey=$APIkey",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 5
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
$result = (array) json_decode($result);
var_dump($result);
Standings
Method
GET apifootball.com/api/?action=get_standings
Returns standings for leagues included in your current subscription plan
Parameters
| Parameter | Description |
|---|---|
| action | API method name |
| APIkey | Authorization code generated from your apifootball account |
| league_id | League internal code |
Request URL
https://apifootball.com/api/?action=get_standings&league_id=62&APIkey=xxxxxxxxxxxxxx
JSON Response
[
{
"country_name":"England",
"league_id":"62",
"league_name":"Premier League",
"team_name":"Arsenal",
"overall_league_position":"4",
"overall_league_payed":"11",
"overall_league_W":"7",
"overall_league_D":"3",
"overall_league_L":"1",
"overall_league_GF":"24",
"overall_league_GA":"11",
"overall_league_PTS":"24",
"home_league_position":"7",
"home_league_payed":"6",
"home_league_W":"3",
"home_league_D":"2",
"home_league_L":"1",
"home_league_GF":"12",
"home_league_GA":"8",
"home_league_PTS":"11",
"away_league_position":"1",
"away_league_payed":"5",
"away_league_W":"4",
"away_league_D":"1",
"away_league_L":"0",
"away_league_GF":"12",
"away_league_GA":"3",
"away_league_PTS":"13"
},
....
]
PHP call example
$APIkey='xxxxxxxxxxxxxx';
$league_id = 62;
$curl_options = array(
CURLOPT_URL => "https://apifootball.com/api/?action=get_standings&league_id=$league_id&APIkey=$APIkey",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 5
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
$result = (array) json_decode($result);
var_dump($result);
?>
Events (Results / Fixtures)
Method
GET apifootball.com/api/?action=get_events
Returns events included in your current subscription plan
Parameters
| Parameter | Description |
|---|---|
| action | API method name |
| APIkey | Authorization code generated from your apifootball account |
| from | Start date (yyyy-mm-dd) |
| to | Stop date (yyyy-mm-dd) |
| country_id | Country ID - if set only leagues from specific country will be returned (Optional) |
| league_id | League ID - if set events from specific league will be returned (Optional) |
| match_id | Match ID - if set only details from specific match will be returned (Optional) |
Request URL
https://apifootball.com/api/?action=get_events&from=2016-10-30&to=2016-11-01&league_id=62&APIkey=xxxxxxxxxxxxxx
JSON Response
[
{
"match_id": "277488",
"country_id": "170",
"country_name": "Italy",
"league_id": "79",
"league_name": "Serie A",
"match_date": "2018-04-22",
"match_status": "FT",
"match_time": "15:00",
"match_hometeam_name": "Juventus",
"match_hometeam_score": "0",
"match_awayteam_name": "SSC Napoli",
"match_awayteam_score": "1",
"match_hometeam_halftime_score": "0",
"match_awayteam_halftime_score": "0",
"match_hometeam_extra_score": "",
"match_awayteam_extra_score": "",
"match_hometeam_penalty_score": "",
"match_awayteam_penalty_score": "",
"match_hometeam_system": "4-3-2-1",
"match_awayteam_system": "4-3-3",
"match_live": "1",
"goalscorer": [
{
"time": "90'",
"home_scorer": "",
"score": "0 - 1",
"away_scorer": "K. Kalidou Koulibaly"
}
],
"cards": [
{
"time": "9'",
"home_fault": "M. Medhi Benatia",
"card": "yellowcard",
"away_fault": ""
},
{
"time": "10'",
"home_fault": "K. Kwadwo Asamoah",
"card": "yellowcard",
"away_fault": ""
},
{
"time": "16'",
"home_fault": "",
"card": "yellowcard",
"away_fault": "R. Raul Albiol"
},
{
"time": "27'",
"home_fault": "M. Miralem Pjanic",
"card": "yellowcard",
"away_fault": ""
}
],
"lineup": {
"home": {
"starting_lineups": [
{
"lineup_player": "Gianluigi Buffon",
"lineup_number": "1",
"lineup_position": "1"
},
{
"lineup_player": "Giorgio Chiellini",
"lineup_number": "3",
"lineup_position": "2"
},
{
"lineup_player": "Medhi Benatia",
"lineup_number": "4",
"lineup_position": "3"
},
{
"lineup_player": "Benedikt Hoewedes",
"lineup_number": "21",
"lineup_position": "4"
},
{
"lineup_player": "Kwadwo Asamoah",
"lineup_number": "22",
"lineup_position": "5"
},
{
"lineup_player": "Sami Khedira",
"lineup_number": "6",
"lineup_position": "6"
},
{
"lineup_player": "Miralem Pjanic",
"lineup_number": "5",
"lineup_position": "7"
},
{
"lineup_player": "Blaise Matuidi",
"lineup_number": "14",
"lineup_position": "8"
},
{
"lineup_player": "Douglas Costa",
"lineup_number": "11",
"lineup_position": "9"
},
{
"lineup_player": "Paulo Dybala",
"lineup_number": "10",
"lineup_position": "10"
},
{
"lineup_player": "Gonzalo Higuain",
"lineup_number": "9",
"lineup_position": "11"
}
],
"substitutes": [
{
"lineup_player": "Juan Cuadrado",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Alex Sandro",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Andrea Barzagli",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Carlo Pinsoglio",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Mario Mandzukic",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Wojciech Szczesny",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Daniele Rugani",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Stephan Lichtsteiner",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Rodrigo Bentancur",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Federico Bernardeschi",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": " ",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": " ",
"lineup_number": "",
"lineup_position": ""
}
],
"coach": [
{
"lineup_player": "Massimiliano Allegri",
"lineup_number": "",
"lineup_position": ""
}
],
"substitutions": [
{
"lineup_player": "Giorgio Chiellini | Stephan Lichtsteiner",
"lineup_number": "",
"lineup_position": "",
"lineup_time": "11'"
},
{
"lineup_player": "Paulo Dybala | Juan Cuadrado",
"lineup_number": "",
"lineup_position": "",
"lineup_time": "46'"
},
{
"lineup_player": "Douglas Costa | Mario Mandzukic",
"lineup_number": "",
"lineup_position": "",
"lineup_time": "71'"
}
]
},
"away": {
"starting_lineups": [
{
"lineup_player": "Lorenzo Insigne",
"lineup_number": "24",
"lineup_position": "11"
},
{
"lineup_player": "Dries Mertens",
"lineup_number": "14",
"lineup_position": "10"
},
{
"lineup_player": "Jose Maria Callejon",
"lineup_number": "7",
"lineup_position": "9"
},
{
"lineup_player": "Marek Hamsik",
"lineup_number": "17",
"lineup_position": "8"
},
{
"lineup_player": "Jorginho",
"lineup_number": "8",
"lineup_position": "7"
},
{
"lineup_player": "Allan",
"lineup_number": "5",
"lineup_position": "6"
},
{
"lineup_player": "Mario Rui",
"lineup_number": "6",
"lineup_position": "5"
},
{
"lineup_player": "Kalidou Koulibaly",
"lineup_number": "26",
"lineup_position": "4"
},
{
"lineup_player": "Raul Albiol",
"lineup_number": "33",
"lineup_position": "3"
},
{
"lineup_player": "Elseid Hysaj",
"lineup_number": "23",
"lineup_position": "2"
},
{
"lineup_player": "Pepe Reina",
"lineup_number": "25",
"lineup_position": "1"
}
],
"substitutes": [
{
"lineup_player": "Rafael",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Christian Maggio",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Hrvoje Milic",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Piotr Zielinski",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Vlad Chiriches",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Luigi Sepe",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Zinedine Machach",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Marko Rog",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Adam Ounas",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Amadou Diawara",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Lorenzo Tonelli",
"lineup_number": "",
"lineup_position": ""
},
{
"lineup_player": "Arkadiusz Milik",
"lineup_number": "",
"lineup_position": ""
}
],
"coach": [
{
"lineup_player": "Maurizio Sarri",
"lineup_number": "",
"lineup_position": ""
}
],
"substitutions": [
{
"lineup_player": "Dries Mertens | Arkadiusz Milik",
"lineup_number": "",
"lineup_position": "",
"lineup_time": "61'"
},
{
"lineup_player": "Marek Hamsik | Piotr Zielinski",
"lineup_number": "",
"lineup_position": "",
"lineup_time": "66'"
},
{
"lineup_player": "Allan | Marko Rog",
"lineup_number": "",
"lineup_position": "",
"lineup_time": "80'"
}
]
}
},
"statistics": [
{
"type": "shots on target",
"home": "1",
"away": "5"
},
{
"type": "shots off target",
"home": "2",
"away": "8"
},
{
"type": "possession (%)",
"home": "44",
"away": "56"
},
{
"type": "corners",
"home": "3",
"away": "3"
},
{
"type": "offsides",
"home": "2",
"away": "4"
},
{
"type": "fouls",
"home": "10",
"away": "17"
},
{
"type": "yellow cards",
"home": "3",
"away": "1"
},
{
"type": "goal kicks",
"home": "9",
"away": "6"
},
{
"type": "treatments",
"home": "3",
"away": "0"
}
]
}
]
PHP call example
$APIkey='xxxxxxxxxxxxxx';
$from = '2016-10-30';
$to = '2016-11-01';
$league_id = 62;
$curl_options = array(
CURLOPT_URL => "https://apifootball.com/api/?action=get_events&from=$from&to=$to&league_id=$league_id&APIkey=$APIkey",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 5
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
$result = (array) json_decode($result);
var_dump($result);
?>
Odds
Method
GET apifootball.com/api/?action=get_odds
Returns odds (1x2, BTS, O/U, AH) for events included in your current subscription plan
Parameters
| Parameter | Description |
|---|---|
| action | API method name |
| APIkey | Authorization code generated from your apifootball account |
| from | Start date (yyyy-mm-dd) |
| to | Stop date (yyyy-mm-dd) |
| match_id | Match ID - if set only odds from specific event will be returned (Optional) |
Request URL
https://apifootball.com/api/?action=get_odds&from=2017-02-13&to=2017-02-13&APIkey=xxxxxxxxxxxxxx
JSON Response
[
{
"match_id":"148356"
,"odd_bookmakers":"10Bet"
,"odd_date":"2017-02-07 07:41:36"
,"odd_1":"1.77"
,"odd_x":"3.74"
,"odd_2":"5.30"
,"ah-2.5_1":"6.25"
,"ah-2.5_2":"1.12"
,"ah-2_1":"5.50"
,"ah-2_2":"1.15"
,"ah-1.5_1":"3.00"
,"ah-1.5_2":"1.38"
,"ah-1_1":"2.44"
,"ah-1_2":"1.65"
,"ah0_1":"1.28"
,"ah0_2":"3.54"
,"o+0.5":"1.07"
,"u+0.5":"9.00"
,"o+1.5":"1.35"
,"u+1.5":"3.10"
,"o+2":"1.58"
,"u+2":"2.35"
,"o+2.5":"2.10"
,"u+2.5":"1.84"
,"o+3":"3.10"
,"u+3":"1.35"
,"o+3.5":"3.80"
,"u+3.5":"1.25"
,"o+4.5":"8.00"
,"u+4.5":"1.08"
,"o+5.5":"19.00"
,"u+5.5":"1.02"
,"bts_yes":"2.00"
,"bts_no":"1.80"
}
]
PHP call example
$APIkey='xxxxxxxxxxxxxx';
$from = '2017-02-13';
$to = '2017-02-13';
$curl_options = array(
CURLOPT_URL => "https://apifootball.com/api/?action=get_odds&from=$from&to=$to&APIkey=$APIkey",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 5
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
$result = (array) json_decode($result);
var_dump($result);
?>
H2H
Method
GET apifootball.com/api/?action=get_H2H
Returns the last games between submiteted teams and the last games of each team
Parameters
| Parameter | Description |
|---|---|
| action | API method name |
| APIkey | Authorization code generated from your apifootball account |
| firstTeam | First team name |
| secondTeam | Second team name |
Request URL
https://apifootball.com/api/?action=get_H2H&firstTeam=Chelsea&secondTeam=Arsenal&APIkey=xxxxxxxxxxxxxx
JSON Response
[
{
"firstTeam_VS_secondTeam": [{
"match_id": "248036",
"country_id": "169",
"country_name": "England",
"league_id": "70",
"league_name": "Capital One Cup",
"match_date": "2018-01-24",
"match_status": "FT",
"match_time": "21:00",
"match_hometeam_name": "Arsenal",
"match_hometeam_score": "2",
"match_awayteam_name": "Chelsea",
"match_awayteam_score": "1",
"match_hometeam_halftime_score": "1",
"match_awayteam_halftime_score": "1",
"match_live": "1"
},
.....
],"firstTeam_lastResults": [{
"match_id": "248036",
"country_id": "169",
"country_name": "England",
"league_id": "70",
"league_name": "Capital One Cup",
"match_date": "2018-01-24",
"match_status": "FT",
"match_time": "21:00",
"match_hometeam_name": "Arsenal",
"match_hometeam_score": "2",
"match_awayteam_name": "Chelsea",
"match_awayteam_score": "1",
"match_hometeam_halftime_score": "1",
"match_awayteam_halftime_score": "1",
"match_live": "1"
},
.....
], "secondTeam_lastResults": [{
"match_id": "248036",
"country_id": "169",
"country_name": "England",
"league_id": "70",
"league_name": "Capital One Cup",
"match_date": "2018-01-24",
"match_status": "FT",
"match_time": "21:00",
"match_hometeam_name": "Arsenal",
"match_hometeam_score": "2",
"match_awayteam_name": "Chelsea",
"match_awayteam_score": "1",
"match_hometeam_halftime_score": "1",
"match_awayteam_halftime_score": "1",
"match_live": "1"
},
.....
]
PHP call example
$APIkey='xxxxxxxxxxxxxx';
$from = '2017-02-13';
$to = '2017-02-13';
$curl_options = array(
CURLOPT_URL => "https://apifootball.com/api/?action=get_H2H&firstTeam=$firstTeam&secondTeam=$secondTeam&APIkey=$APIkey",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 5
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
$result = (array) json_decode($result);
var_dump($result);
?>
Predictions
Method
GET apifootball.com/api/?action=get_predictions
Returns mathematical calculated predictions for the events included in your current subscription plan
Parameters
| Parameter | Description |
|---|---|
| action | API method name |
| APIkey | Authorization code generated from your apifootball account |
| from | Start date (yyyy-mm-dd) |
| to | Stop date (yyyy-mm-dd) |
| country_id | Country ID - if set only leagues from specific country will be returned (Optional) |
| league_id | League ID - if set events from specific league will be returned (Optional) |
| match_id | Match ID - if set only details from specific match will be returned (Optional) |
Request URL
https://apifootball.com/api/?action=get_predictions&from=2019-01-08&to=2019-01-08&APIkey=xxxxxxxxxxxxxx
JSON Response
[
{
"match_id": "369090",
"country_id": "253",
"country_name": "Australia",
"league_id": "684",
"league_name": "A-League",
"match_date": "2019-01-08",
"match_status": "FT",
"match_time": "08:50",
"match_hometeam_name": "Western Sydney Wanderers FC",
"match_hometeam_score": "2",
"match_awayteam_name": "Wellington Phoenix FC",
"match_awayteam_score": "3",
"match_hometeam_halftime_score": "1",
"match_awayteam_halftime_score": "1",
"match_hometeam_extra_score": "",
"match_awayteam_extra_score": "",
"match_hometeam_penalty_score": "",
"match_awayteam_penalty_score": "",
"match_hometeam_system": "4-3-3",
"match_awayteam_system": "3-4-3",
"match_live": "0",
"prob_HW": "20.00",
"prob_D": "25.00",
"prob_AW": "55.00",
"prob_HW_D": "45.00",
"prob_AW_D": "80.00",
"prob_HW_AW": "75.00",
"prob_O": "43.00",
"prob_U": "57.00",
"prob_O_1": "69.00",
"prob_U_1": "31.00",
"prob_O_3": "22.00",
"prob_U_3": "78.00",
"prob_bts": "44.00",
"prob_ots": "56.00",
"prob_ah_h_45": "99.00",
"prob_ah_a_45": "1.00",
"prob_ah_h_35": "96.00",
"prob_ah_a_35": "4.00",
"prob_ah_h_25": "88.00",
"prob_ah_a_25": "12.00",
"prob_ah_h_15": "71.00",
"prob_ah_a_15": "29.00",
"prob_ah_h_05": "45.00",
"prob_ah_a_05": "55.00",
"prob_ah_h_-05": "20.00",
"prob_ah_a_-05": "80.00",
"prob_ah_h_-15": "6.00",
"prob_ah_a_-15": "94.00",
"prob_ah_h_-25": "1.00",
"prob_ah_a_-25": "99.00",
"prob_ah_h_-35": "0.00",
"prob_ah_a_-35": "100.00",
"prob_ah_h_-45": "0.00",
"prob_ah_a_-45": "100.00"
}
........
]
PHP call example
$APIkey='xxxxxxxxxxxxxx';
$from = '2019-01-08';
$to = '2019-01-08';
$curl_options = array(
CURLOPT_URL => "https://apifootball.com/api/?action=get_predictions&from=$from&to=$to&APIkey=$APIkey",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 5
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
$result = (array) json_decode($result);
var_dump($result);
?>
Livescore
For Livescore just call apifootball.com/api/?action=get_events method and filter for match_live = 1 on todays matches every minute