Documentation API V3

  • Version: 3.0.1
  • Created: 2021-05-20
  • Latest Update: 2021-05-21

Countries


Method

GET apiv3.apifootball.com/?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


JSON Response

[
    {
        "country_id": "44",
        "country_name": "England",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/44_england.png"
    },
    {
        "country_id": "6",
        "country_name": "Spain",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
    },
    {
        "country_id": "3",
        "country_name": "France",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/3_france.png"
    },
    {
        "country_id": "4",
        "country_name": "Germany",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/4_germany.png"
    },
    {
        "country_id": "5",
        "country_name": "Italy",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/5_italy.png"
    },
    ....
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?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 apiv3.apifootball.com/?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


JSON Response

[
    {
        "country_id": "6",
        "country_name": "Spain",
        "league_id": "300",
        "league_name": "Copa del Rey",
        "league_season": "2020/2021",
        "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/300_copa-del-rey.png",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
    },
    {
        "country_id": "6",
        "country_name": "Spain",
        "league_id": "302",
        "league_name": "La Liga",
        "league_season": "2020/2021",
        "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/302_la-liga.png",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
    },
    {
        "country_id": "6",
        "country_name": "Spain",
        "league_id": "301",
        "league_name": "Segunda División",
        "league_season": "2020/2021",
        "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/301_segunda-división.png",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
    },
    {
        "country_id": "6",
        "country_name": "Spain",
        "league_id": "383",
        "league_name": "Super Cup",
        "league_season": "2021",
        "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/383_super-cup.png",
        "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
    },
    ......
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$country_id = 6;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?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);

            

Teams


Method

GET apiv3.apifootball.com/?action=get_teams

Returns list of available teams


Parameters

Parameter Description
action API method name
APIkey Authorization code generated from your apifootball account
team_id Team ID - team id mandatory if league id is not set
league_id League ID - league id mandatory if team id is not set

Request URL


JSON Response

[
    {
        "team_key": "73",
        "team_name": "Atletico Madrid",
        "team_badge": "https://apiv3.apifootball.com/badges/73_atl.-madrid.jpg",
        "players": [
            {
                "player_key": "106805300",
                "player_id": "106805300",
                "player_name": "I. Grbić",
                "player_number": "1",
                "player_country": "",
                "player_type": "Goalkeepers",
                "player_age": "25",
                "player_match_played": "0",
                "player_goals": "0",
                "player_yellow_cards": "0",
                "player_red_cards": "0",
                "player_injured": "No",
                "player_substitute_out": "0",
                "player_substitutes_on_bench": "32",
                "player_assists": "0",
                "player_is_captain": "0",
                "player_shots_total": "",
                "player_goals_conceded": "0",
                "player_fouls_committed": "",
                "player_tackles": "",
                "player_blocks": "",
                "player_crosses_total": "",
                "player_interceptions": "",
                "player_clearances": "",
                "player_dispossesed": "",
                "player_saves": "",
                "player_inside_box_saves": "",
                "player_duels_total": "",
                "player_duels_won": "",
                "player_dribble_attempts": "",
                "player_dribble_succ": "",
                "player_pen_comm": "",
                "player_pen_won": "",
                "player_pen_scored": "0",
                "player_pen_missed": "0",
                "player_passes": "",
                "player_passes_accuracy": "",
                "player_key_passes": "",
                "player_woordworks": "",
                "player_rating": ""
            },
            {
                "player_key": 1770510014,
                "player_id": "1770510014",
                "player_name": "J. Oblak",
                "player_number": "13",
                "player_country": "",
                "player_type": "Goalkeepers",
                "player_age": "28",
                "player_match_played": "35",
                "player_goals": "0",
                "player_yellow_cards": "0",
                "player_red_cards": "0",
                "player_injured": "No",
                "player_substitute_out": "0",
                "player_substitutes_on_bench": "0",
                "player_assists": "0",
                "player_is_captain": "4",
                "player_shots_total": "",
                "player_goals_conceded": "22",
                "player_fouls_committed": "",
                "player_tackles": "",
                "player_blocks": "",
                "player_crosses_total": "",
                "player_interceptions": "",
                "player_clearances": "18",
                "player_dispossesed": "",
                "player_saves": "93",
                "player_inside_box_saves": "59",
                "player_duels_total": "13",
                "player_duels_won": "12",
                "player_dribble_attempts": "1",
                "player_dribble_succ": "1",
                "player_pen_comm": "",
                "player_pen_won": "",
                "player_pen_scored": "0",
                "player_pen_missed": "0",
                "player_passes": "810",
                "player_passes_accuracy": "487",
                "player_key_passes": "",
                "player_woordworks": "",
                "player_rating": "7.16"
            },
	  .........
    ],
    "coaches": [
         {
             "coach_name": "D. Simeone",
             "coach_country": "",
             "coach_age": ""
         }
     ]
  },
  ........
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$league_id = 302;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?action=get_teams&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);

            

Players


Method

GET apiv3.apifootball.com/?action=get_players

Returns available players


Parameters

Parameter Description
action API method name
APIkey Authorization code generated from your apifootball account
player_id Player ID - mandatory if player name is not set
player_name Player Name - mandatory if player id is not set

Request URL


JSON Response

[
    {
        "player_key": 2722594872,
        "player_id": "2722594872",
        "player_name": "K. Trippier",
        "player_number": "23",
        "player_country": "",
        "player_type": "Defenders",
        "player_age": "30",
        "player_match_played": "27",
        "player_goals": "0",
        "player_yellow_cards": "0",
        "player_red_cards": "0",
        "player_minutes": "2387",
        "player_injured": "No",
        "player_substitute_out": "2",
        "player_substitutes_on_bench": "0",
        "player_assists": "6",
        "player_is_captain": "0",
        "player_shots_total": "2",
        "player_goals_conceded": "0",
        "player_fouls_committed": "30",
        "player_tackles": "58",
        "player_blocks": "4",
        "player_crosses_total": "101",
        "player_interceptions": "39",
        "player_clearances": "46",
        "player_dispossesed": "7",
        "player_saves": "",
        "player_inside_box_saves": "",
        "player_duels_total": "215",
        "player_duels_won": "126",
        "player_dribble_attempts": "22",
        "player_dribble_succ": "16",
        "player_pen_comm": "",
        "player_pen_won": "",
        "player_pen_scored": "0",
        "player_pen_missed": "0",
        "player_passes": "1450",
        "player_passes_accuracy": "1152",
        "player_key_passes": "34",
        "player_woordworks": "",
        "player_rating": "7.24",
        "team_name": "Atletico Madrid",
        "team_key": "73"
    },
    .....
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$player_name = "K. Trippier";

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?action=get_players&player_name=$player_name&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 apiv3.apifootball.com/?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


JSON Response

[
    {
        "country_name": "Spain",
        "league_id": "302",
        "league_name": "La Liga",
        "team_id": "76",
        "team_name": "Real Madrid",
        "overall_promotion": "Promotion - Champions League (Group Stage)",
        "overall_league_position": "1",
        "overall_league_payed": "37",
        "overall_league_W": "24",
        "overall_league_D": "9",
        "overall_league_L": "4",
        "overall_league_GF": "65",
        "overall_league_GA": "27",
        "overall_league_PTS": "81",
        "home_league_position": "",
        "home_promotion": "",
        "home_league_payed": "",
        "home_league_W": "",
        "home_league_D": "",
        "home_league_L": "",
        "home_league_GF": "",
        "home_league_GA": "",
        "home_league_PTS": "",
        "away_league_position": "",
        "away_promotion": "",
        "away_league_payed": "",
        "away_league_W": "",
        "away_league_D": "",
        "away_league_L": "",
        "away_league_GF": "",
        "away_league_GA": "",
        "away_league_PTS": "",
        "league_round": "Current",
        "team_badge": "https://apiv3.apifootball.com/badges/76_real-madrid.jpg",
        "fk_stage_key": "402",
        "stage_name": "Current"
    },
    {
        "country_name": "Spain",
        "league_id": "302",
        "league_name": "La Liga",
        "team_id": "73",
        "team_name": "Atl. Madrid",
        "overall_promotion": "Promotion - Champions League (Group Stage)",
        "overall_league_position": "2",
        "overall_league_payed": "36",
        "overall_league_W": "24",
        "overall_league_D": "8",
        "overall_league_L": "4",
        "overall_league_GF": "63",
        "overall_league_GA": "23",
        "overall_league_PTS": "80",
        "home_league_position": "",
        "home_promotion": "",
        "home_league_payed": "",
        "home_league_W": "",
        "home_league_D": "",
        "home_league_L": "",
        "home_league_GF": "",
        "home_league_GA": "",
        "home_league_PTS": "",
        "away_league_position": "",
        "away_promotion": "",
        "away_league_payed": "",
        "away_league_W": "",
        "away_league_D": "",
        "away_league_L": "",
        "away_league_GF": "",
        "away_league_GA": "",
        "away_league_PTS": "",
        "league_round": "Current",
        "team_badge": "https://apiv3.apifootball.com/badges/73_atletico-madrid.jpg",
        "fk_stage_key": "402",
        "stage_name": "Current"
    },
    .....
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$league_id = 302;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?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 apiv3.apifootball.com/?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
timezone Default timezone: Europe/Berlin. With this filter you can set the timezone where you want to receive the data. Timezone is in TZ format (exemple: America/New_York). (Optional)
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)
team_id Team ID - if set only details from specific team will be returned (Optional)

Request URL


JSON Response

[
    {
        "match_id": "902316",
        "country_id": "1",
        "country_name": "Eurocups",
        "league_id": "1",
        "league_name": "European Championship - Final",
        "match_date": "2021-07-11",
        "match_status": "After Pen.",
        "match_time": "21:00",
        "match_hometeam_id": "3",
        "match_hometeam_name": "Italy",
        "match_hometeam_score": "2",
        "match_awayteam_name": "England",
        "match_awayteam_id": "16",
        "match_awayteam_score": "1",
        "match_hometeam_halftime_score": "0",
        "match_awayteam_halftime_score": "1",
        "match_hometeam_extra_score": "0",
        "match_awayteam_extra_score": "0",
        "match_hometeam_penalty_score": "3",
        "match_awayteam_penalty_score": "2",
        "match_hometeam_ft_score": "1",
        "match_awayteam_ft_score": "1",
        "match_hometeam_system": "4-3-3",
        "match_awayteam_system": "3-4-2-1",
        "match_live": "0",
        "match_round": "Final",
        "match_stadium": "Wembley Stadium (London)",
        "match_referee": "B. Kuipers",
        "team_home_badge": "https://apiv3.apifootball.com/badges/3_italy.jpg",
        "team_away_badge": "https://apiv3.apifootball.com/badges/16_england.jpg",
        "league_logo": "",
        "country_logo": "",
        "fk_stage_key": "4",
        "stage_name": "Final",
        "goalscorer": [
            {
                "time": "2",
                "home_scorer": "",
                "home_scorer_id": "",
                "home_assist": "",
                "home_assist_id": "",
                "score": "0 - 1",
                "away_scorer": "L. Shaw",
                "away_scorer_id": "2013220432",
                "away_assist": "K. Trippier",
                "away_assist_id": "2722594872",
                "info": ""
            },
            ................
        ],
        "cards": [
            {
                "time": "47",
                "home_fault": "N. Barella",
                "card": "yellow card",
                "away_fault": "",
                "info": ""
            },
            ...............
        ],
        "substitutions": {
            "home": [
                {
                    "time": "54",
                    "substitution": "N. Barella | B. Cristante"
                },
                ..............
            ],
            "away": [
                {
                    "time": "70",
                    "substitution": "K. Trippier | B. Saka"
                },
                .............
            ]
        },
        "lineup": {
            "home": {
                "starting_lineups": [
                    {
                        "lineup_player": "Ciro Immobile",
                        "lineup_number": "17",
                        "lineup_position": "10",
                        "player_key": "2681696639"
                    },
                    ...............
                ],
                "substitutes": [
                    {
                        "lineup_player": "Alessandro Bastoni",
                        "lineup_number": "23",
                        "lineup_position": "0",
                        "player_key": "2283533776"
                    },
                    .................
                ],
                "coach": [
                    {
                        "lineup_player": "R. Mancini",
                        "lineup_number": "",
                        "lineup_position": "",
                        "player_key": "3244928587"
                    }
                ],
                "missing_players": []
            },
            "away": {
                "starting_lineups": [
                    {
                        "lineup_player": "Declan Rice",
                        "lineup_number": "4",
                        "lineup_position": "7",
                        "player_key": "353204575"
                    },
                    ..................
                ],
                "substitutes": [
                    {
                        "lineup_player": "Aaron Ramsdale",
                        "lineup_number": "13",
                        "lineup_position": "0",
                        "player_key": "2971117080"
                    },
                    .................
                ],
                "coach": [
                    {
                        "lineup_player": "G. Southgate",
                        "lineup_number": "",
                        "lineup_position": "",
                        "player_key": "2968444313"
                    }
                ],
                "missing_players": []
            }
        },
        "statistics": [
            {
                "type": "Shots Total",
                "home": "19",
                "away": "6"
            },
            ....................
        ],
        "statistics_1half": [
            {
                "type": "Shots Total",
                "home": "17",
                "away": "5"
            },
            .................
        ]
    }
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$from = '2021-07-12';
$to = '2021-07-12';
$league_id = 1;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?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);
?>

            

Lineups


Method

GET apiv3.apifootball.com/?action=get_lineups

Returns lineups of one event


Parameters

Parameter Description
action API method name
APIkey Authorization code generated from your apifootball account
match_id Match ID

Request URL


JSON Response

{
    "86392": {
        "lineup": {
            "home": {
                "starting_lineups": [
                    {
                        "lineup_player": "Fernando Pacheco",
                        "lineup_number": "1",
                        "lineup_position": "1",
                        "player_key": "2697551827"
                    },
                    {
                        "lineup_player": "Florian Lejeune",
                        "lineup_number": "22",
                        "lineup_position": "4",
                        "player_key": "676474805"
                    },
                    ..................
                ],
                "substitutes": [
                    {
                        "lineup_player": "Abdallahi Mahmoud",
                        "lineup_number": "30",
                        "lineup_position": "0",
                        "player_key": "3323219436"
                    },
                    {
                        "lineup_player": "Alberto Rodríguez",
                        "lineup_number": "2",
                        "lineup_position": "0",
                        "player_key": "3090376076"
                    },
                    ..................
                ],
                "coach": [
                    {
                        "lineup_player": "Javi Calleja",
                        "lineup_number": "",
                        "lineup_position": "",
                        "player_key": "2090999962"
                    }
                ],
                "missing_players": []
            },
            "away": {
                "starting_lineups": [
                    {
                        "lineup_player": "Aarón Escandell",
                        "lineup_number": "13",
                        "lineup_position": "1",
                        "player_key": "4163952067"
                    },
                    {
                        "lineup_player": "Adrián Marín",
                        "lineup_number": "18",
                        "lineup_position": "10",
                        "player_key": "2956156479"
                    },
                    ...................
                ],
                "substitutes": [
                    {
                        "lineup_player": "Antonio Puertas",
                        "lineup_number": "10",
                        "lineup_position": "0",
                        "player_key": "1306175954"
                    },
                    {
                        "lineup_player": "Arnau Fàbrega",
                        "lineup_number": "31",
                        "lineup_position": "0",
                        "player_key": "3737665595"
                    },
                    ............
                ],
                "coach": [
                    {
                        "lineup_player": "Diego Martínez",
                        "lineup_number": "",
                        "lineup_position": "",
                        "player_key": "46479144"
                    }
                ],
                "missing_players": []
            }
        }
    }
}
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$match_id = 86392;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?action=get_lineups&match_id=$match_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);
?>

            

Statistics


Method

GET apiv3.apifootball.com/?action=get_statistics

Returns statistics of one event


Parameters

Parameter Description
action API method name
APIkey Authorization code generated from your apifootball account
match_id Match ID

Request URL


JSON Response

{
    "86392": {
        "statistics": [
            {
                "type": "Shots Total",
                "home": "14",
                "away": "5"
            },
            {
                "type": "Shots On Goal",
                "home": "9",
                "away": "2"
            },
            {
                "type": "Shots Off Goal",
                "home": "4",
                "away": "2"
            },
            {
                "type": "Shots Blocked",
                "home": "1",
                "away": "1"
            },
            {
                "type": "Shots Inside Box",
                "home": "13",
                "away": "2"
            },
            {
                "type": "Shots Outside Box",
                "home": "1",
                "away": "3"
            },
            {
                "type": "Fouls",
                "home": "7",
                "away": "11"
            },
            {
                "type": "Corners",
                "home": "6",
                "away": "1"
            },
            {
                "type": "Offsides",
                "home": "1",
                "away": "2"
            },
            {
                "type": "Ball Possession",
                "home": "53%",
                "away": "47%"
            },
            {
                "type": "Yellow Cards",
                "home": "2",
                "away": "4"
            },
            {
                "type": "Saves",
                "home": "0",
                "away": "5"
            },
            {
                "type": "Passes Total",
                "home": "458",
                "away": "406"
            },
            {
                "type": "Passes Accurate",
                "home": "360",
                "away": "302"
            }
        ],
        "player_statistics": [
            {
                "player_name": "Fernando Pacheco",
                "player_key": "2697551827",
                "team_name": "home",
                "player_number": "1",
                "player_position": "Goalkeepers",
                "player_is_captain": "True",
                "player_is_subst": "False",
                "player_shots_total": "0",
                "player_shots_on_goal": "0",
                "player_goals": "0",
                "player_goals_conceded": "2",
                "player_minus_goals": "2",
                "player_assists": "0",
                "player_offsides": "0",
                "player_fouls_drawn": "",
                "player_fouls_commited": "0",
                "player_tackles": "0",
                "player_blocks": "0",
                "player_total_crosses": "0",
                "player_acc_crosses": "0",
                "player_interceptions": "0",
                "player_clearances": "0",
                "player_dispossesed": "0",
                "player_saves": "0",
                "player_punches": "0",
                "player_saves_inside_box": "0",
                "player_duels_total": "0",
                "player_duels_won": "0",
                "player_aerials_won": "0",
                "player_dribble_attempts": "0",
                "player_dribble_succ": "0",
                "player_dribbled_past": "0",
                "player_yellowcards": "0",
                "player_redcards": "0",
                "player_pen_score": "0",
                "player_pen_miss": "0",
                "player_pen_save": "0",
                "player_pen_committed": "0",
                "player_pen_won": "0",
                "player_hit_woodwork": "0",
                "player_passes": "22",
                "player_passes_acc": "18",
                "player_key_passes": "0",
                "player_minutes_played": "90",
                "player_rating": "6",
                "match_id": "86392"
            },
            .................
        ]
    }
}
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$match_id = 86392;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?action=action=get_statistics&match_id=$match_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 apiv3.apifootball.com/?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


JSON Response

[
    {
        "match_id": "137523",
        "odd_bookmakers": "bwin",
        "odd_date": "2021-04-17 20:26:25",
        "odd_1": "1.67",
        "odd_x": "3.50",
        "odd_2": "4.50",
        "odd_1x": "1.16",
        "odd_12": "1.25",
        "odd_x2": "2.00",
        "ah-4.5_1": "",
        "ah-4.5_2": "",
        "ah-4_1": "",
        "ah-4_2": "",
        "ah-3.5_1": "",
        "ah-3.5_2": "",
        "ah-3_1": "",
        "ah-3_2": "",
        "ah-2.5_1": "",
        "ah-2.5_2": "",
        "ah-2_1": "",
        "ah-2_2": "",
        "ah-1.5_1": "",
        "ah-1.5_2": "",
        "ah-1_1": "",
        "ah-1_2": "",
        "ah0_1": "",
        "ah0_2": "",
        "ah+0.5_1": "",
        "ah+1_1": "",
        "ah+1_2": "",
        "ah+1.5_1": "",
        "ah+1.5_2": "",
        "ah+2_1": "",
        "ah+2_2": "",
        "ah+2.5_1": "",
        "ah+2.5_2": "",
        "ah+3_1": "",
        "ah+3_2": "",
        "ah+3.5_1": "",
        "ah+3.5_2": "",
        "ah+4_1": "",
        "ah+4_2": "",
        "ah+4.5_1": "",
        "ah+4.5_2": "",
        "o+0.5": "",
        "u+0.5": "",
        "o+1": "",
        "u+1": "",
        "o+1.5": "",
        "u+1.5": "",
        "o+2": "",
        "u+2": "",
        "o+2.5": "1.44",
        "u+2.5": "2.60",
        "o+3": "",
        "u+3": "",
        "o+3.5": "2.00",
        "u+3.5": "1.72",
        "o+4": "",
        "u+4": "",
        "o+4.5": "",
        "u+4.5": "",
        "o+5": "",
        "u+5": "",
        "o+5.5": "",
        "u+5.5": "",
        "bts_yes": "1.44",
        "bts_no": "2.60"
    },
    ............
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$from = '2021-05-16';
$to = '2021-05-16';

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?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 apiv3.apifootball.com/?action=get_H2H

Returns the last games between submiteted teams and the last games of each team with name parameters (firstTeam and secondTeam) or ids parameters (firstTeamId or secondTeamId)


Parameters

Parameter Description
action API method name
APIkey Authorization code generated from your apifootball account
timezone Default timezone: Europe/Berlin. With this filter you can set the timezone where you want to receive the data. Timezone is in TZ format (exemple: America/New_York). (Optional)
firstTeam First team name
secondTeam Second team name
firstTeamId First team Id
secondTeamId Second team Id

Request URL


JSON Response

{
    "firstTeam_VS_secondTeam": [
        {
            "match_id": "86392",
            "country_id": "6",
            "country_name": "Spain",
            "league_id": "302",
            "league_name": "La Liga",
            "match_date": "2021-05-16",
            "match_status": "Finished",
            "match_time": "18:30",
            "match_hometeam_id": "7275",
            "match_hometeam_name": "Deportivo Alavés",
            "match_hometeam_score": "4",
            "match_awayteam_id": "151",
            "match_awayteam_name": "Granada",
            "match_awayteam_score": "2",
            "match_hometeam_halftime_score": "",
            "match_awayteam_halftime_score": "",
            "match_live": "0",
            "team_home_badge": "https://apiv3.apifootball.com/badges/7275_deportivo-alaves.jpg",
            "team_away_badge": "https://apiv3.apifootball.com/badges/151_granada.jpg",
            "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/302_la-liga.png",
            "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
        },
        .............
    ],
    "firstTeam_lastResults": [
        {
            "match_id": "86392",
            "country_id": "6",
            "country_name": "Spain",
            "league_id": "302",
            "league_name": "La Liga",
            "match_date": "2021-05-16",
            "match_status": "Finished",
            "match_time": "18:30",
            "match_hometeam_id": "7275",
            "match_hometeam_name": "Deportivo Alavés",
            "match_hometeam_score": "4",
            "match_awayteam_id": "151",
            "match_awayteam_name": "Granada",
            "match_awayteam_score": "2",
            "match_hometeam_halftime_score": "",
            "match_awayteam_halftime_score": "",
            "match_live": "0",
            "team_home_badge": "https://apiv3.apifootball.com/badges/7275_deportivo-alaves.jpg",
            "team_away_badge": "https://apiv3.apifootball.com/badges/151_granada.jpg",
            "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/302_la-liga.png",
            "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
        },
        ................
    ],
    "secondTeam_lastResults": [
        {
            "match_id": "86392",
            "country_id": "6",
            "country_name": "Spain",
            "league_id": "302",
            "league_name": "La Liga",
            "match_date": "2021-05-16",
            "match_status": "Finished",
            "match_time": "18:30",
            "match_hometeam_id": "7275",
            "match_hometeam_name": "Deportivo Alavés",
            "match_hometeam_score": "4",
            "match_awayteam_id": "151",
            "match_awayteam_name": "Granada",
            "match_awayteam_score": "2",
            "match_hometeam_halftime_score": "",
            "match_awayteam_halftime_score": "",
            "match_live": "0",
            "team_home_badge": "https://apiv3.apifootball.com/badges/7275_deportivo-alaves.jpg",
            "team_away_badge": "https://apiv3.apifootball.com/badges/151_granada.jpg",
            "league_logo": "https://apiv3.apifootball.com/badges/logo_leagues/302_la-liga.png",
            "country_logo": "https://apiv3.apifootball.com/badges/logo_country/6_spain.png"
        },
        ...................
    ]
}            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$firstTeamId = 7275;
$secondTeamId = 151;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?action=get_H2H&firstTeamId=$firstTeamId&secondTeamId=$secondTeamId&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 apiv3.apifootball.com/?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


JSON Response

[
  {
      "match_id": "86392",
      "country_id": "6",
      "country_name": "Spain",
      "league_id": "302",
      "league_name": "La Liga",
      "match_date": "2021-05-16",
      "match_status": "Finished",
      "match_time": "18:30",
      "match_hometeam_id": "7275",
      "match_hometeam_name": "Deportivo Alavés",
      "match_hometeam_score": "4",
      "match_awayteam_name": "Granada",
      "match_awayteam_id": "151",
      "match_awayteam_score": "2",
      "match_hometeam_halftime_score": "",
      "match_awayteam_halftime_score": "",
      "match_hometeam_extra_score": "",
      "match_awayteam_extra_score": "",
      "match_hometeam_penalty_score": "",
      "match_awayteam_penalty_score": "",
      "match_hometeam_system": "4-4-2",
      "match_awayteam_system": "4-2-3-1",
      "match_live": "0",
      "prob_HW": "39.00",
      "prob_D": "25.00",
      "prob_AW": "36.00",
      "prob_HW_D": "64.00",
      "prob_AW_D": "61.00",
      "prob_HW_AW": "75.00",
      "prob_O": "56.00",
      "prob_U": "44.00",
      "prob_O_1": "79.00",
      "prob_U_1": "21.00",
      "prob_O_3": "34.00",
      "prob_U_3": "66.00",
      "prob_bts": "59.00",
      "prob_ots": "41.00",
      "prob_ah_h_45": "100.00",
      "prob_ah_a_45": "0.00",
      "prob_ah_h_35": "98.00",
      "prob_ah_a_35": "2.00",
      "prob_ah_h_25": "94.00",
      "prob_ah_a_25": "6.00",
      "prob_ah_h_15": "83.00",
      "prob_ah_a_15": "17.00",
      "prob_ah_h_05": "64.00",
      "prob_ah_a_05": "36.00",
      "prob_ah_h_-05": "39.00",
      "prob_ah_a_-05": "61.00",
      "prob_ah_h_-15": "19.00",
      "prob_ah_a_-15": "81.00",
      "prob_ah_h_-25": "7.00",
      "prob_ah_a_-25": "93.00",
      "prob_ah_h_-35": "2.00",
      "prob_ah_a_-35": "98.00",
      "prob_ah_h_-45": "1.00",
      "prob_ah_a_-45": "99.00"
  },
  ........
 ]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$from = '2021-05-16';
$to = '2021-05-16';

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?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);
?>

            

TopScorers


Method

GET apiv3.apifootball.com/?action=get_topscorers

Returns topsorers for leagues


Parameters

Parameter Description
action API method name
APIkey Authorization code generated from your apifootball account
league_id League ID - topscorers from specific league will be returned

Request URL


JSON Response

[
    {
        "player_place": "1",
        "player_name": "L. Messi",
        "player_key": 1135663375,
        "team_name": "Barcelona",
        "team_key": "97",
        "goals": "30",
        "assists": "9",
        "penalty_goals": "3"
    },
    {
        "player_place": "2",
        "player_name": "Gerard Moreno",
        "player_key": 387294631,
        "team_name": "Villarreal",
        "team_key": "162",
        "goals": "23",
        "assists": "",
        "penalty_goals": "10"
    },
    ...............
]
            

PHP call example


$APIkey='xxxxxxxxxxxxxx';
$league_id = 148;

$curl_options = array(
  CURLOPT_URL => "https://apiv3.apifootball.com/?action=get_topscorers&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);
?>

            

Livescore


Widgets


Wordpress Plugin