API-FOOTBALL API: How To Use the API | RapidAPI

API-FOOTBALL

FREEMIUM
By api-sports
Updated 18 hours ago
Sports
9.9/10
Popularity Score
250ms
Latency
100%
Success Rate

API-FOOTBALL API Overview

We cover 375 football major and minor leagues and many more to come. Livescore, pre-matchs odds, events, line-ups, coachs, players, top scorers, standings, statistics, transfers, predictions. Documentation : https://www.api-football.com/documentation | Demo => https://www.api-football.com/demo/ | Beta => https://rapidapi.com/api-sports/api/api-football-beta

Contact API Provider
star-blueRate

October 1, 2019 price decrease for overages

FREE PLAN: from $0.05 to $0.005 per additional request
PRO PLAN: from $0.025 to $0.0025 per additional request
ULTRA PLAN: from $0.015 to $0.0015 per additional request
MEGA PLAN: from $0.010 to $0.0010 per additional request

  • Overages are the fees applied for each request beyond the limit to the plan you have subscribed.

To benefit from it you must unsubscribe and then subscribe again to the plan chosen in accordance with rapidApi's general terms and conditions of subscriptions

COVERAGE

To know all the leagues/cups available : https://www.api-football.com/coverage

FULL DOCUMENTATION

Consult our documentation to find out what's new : https://www.api-football.com/documentation

ARCHITECTURE

Timezone

Get the list of available API time zones to be used in the [fixtures] endpoint

Parameters

This endpoint does not require any parameters

Requests

GET

get("https://api-football-v1.p.rapidapi.com/v2/timezone");

Response Model

{
    "api": {
        "results": 425,
        "timezone": [
            "Africa/Abidjan",
            "Africa/Accra",
            "Africa/Addis_Ababa",
            "Africa/Algiers",
        ]
    }
}

Seasons

All seasons are only 4-digit keys, so for a league whose season is 2018-2019 like the English Premier League, the 2018-2019 season in the API will be 2018

All {season} can be used in other endpoints as filters

Parameters

This endpoint does not require any parameters

Requests

GET All

Get all available {season}

get("https://api-football-v1.p.rapidapi.com/v2/seasons");

Response Model

{
    "api": {
        "results": 10,
        "seasons": [
            2010,
            2011,
            2012,
            2013,
            2014,
            2015,
            2016,
            2017,
            2018,
            2019
        ]
    }
}

Countries

The {country} and {code} keys can be used in other endpoints as filters

Parameters

This endpoint does not require any parameters

Requests

GET All

Get all available {country} in the API across all {season} and competitions

get("https://api-football-v1.p.rapidapi.com/v2/countries");

Response Model

{
    "api": {
        "results": 62,
        "countries": [
            {
                "country": "Algeria",
                "code": "DZ",
                "flag": "https://media.api-football.com/flags/dz.svg"
            },
            {
                "country": "Argentina",
                "code": "AR",
                "flag": "https://media.api-football.com/flags/ar.svg"
            },
            {
                "country": "Australia",
                "code": "AU",
                "flag": "https://media.api-football.com/flags/au.svg"
            }
        ]
    }
}

Leagues

Leagues are updated several times a day

The {league_id} are unique in the API and represent a league/cup for a specific {season}

Ex :

  • English Premier League, season 2018-2019, league {id} : 2
  • English Premier League, season 2019-2020, league {id} : 524

Parameters

Parameter Type Required Description
league_id integer false Fails if field contains anything other than an integer
team_id integer false Fails if field contains anything other than an integer
search string false 3 characters minimum | Fails if field has anything other than alphabetic characters
country string false Fails if field contains anything other than alpha-numeric characters, underscores or dashes
code string false 2 characters | Fails if field has anything other than alphabetic characters | Ex : FR, GB, IT...
season integer false Fails if field contains anything other than an integer [YYYY]

Requests

GET All

Get all available leagues

get("https://api-football-v1.p.rapidapi.com/v2/leagues");

GET By league_id

Get one league from one {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/leagues/league/{league_id}");

GET By team

Get all leagues in which the {team_id} has played at least one match

get("https://api-football-v1.p.rapidapi.com/v2/leagues/team/{team_id}");

GET By team & season

Get all leagues in which the {team_id} has played at least one match in one {season}

get("https://api-football-v1.p.rapidapi.com/v2/leagues/team/{team_id}/{season}");

GET By search

Allows you to search for a league in relation to a league {name} or {country}

Spaces must be replaced by underscore for better search performance.
EX : premier league => premier_league

get("https://api-football-v1.p.rapidapi.com/v2/leagues/search/{name}");
get("https://api-football-v1.p.rapidapi.com/v2/leagues/search/{country}");

GET By country

Get all leagues from one {country}

You can find the available {country} by using the endpoint [country]

get("https://api-football-v1.p.rapidapi.com/v2/leagues/country/{country}");

GET By country & season

Get all leagues from one {country} & filter by {season}

You can find the available {country} by using the endpoint [country]

get("https://api-football-v1.p.rapidapi.com/v2/leagues/country/{country}/{season}");

GET By code

Get all leagues from one country {code} (GB, FR, IT etc..)

You can find the available country {code} by using the endpoint [country]

get("https://api-football-v1.p.rapidapi.com/v2/leagues/country/{code}");

GET By code & season

Get all leagues from one country {code} (GB, FR, IT etc..) & filter by {season}

You can find the available country {code} by using the endpoint [country]

get("https://api-football-v1.p.rapidapi.com/v2/leagues/country/{code}/{season}");

GET By season

Get all leagues from one {season}

You can find the available {season} by using the endpoint [seasons]

get("https://api-football-v1.p.rapidapi.com/v2/leagues/season/{season}");

GET seasons available

Allows to retrieve all the seasons available for a {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/leagues/seasonsAvailable/{league_id}");

GET seasons available

Allows to retrieve all the seasons available for a {league_id} & filter by {season}

get("https://api-football-v1.p.rapidapi.com/v2/leagues/seasonsAvailable/{league_id}/{season}");

Response Model

{
    "api": {
        "results": 970,
        "leagues": [
            {
                "league_id": 1,
                "name": "World Cup",
                "type": "Cup",
                "country": "World",
                "country_code": null,
                "season": 2018,
                "season_start": "2018-06-14",
                "season_end": "2018-07-15",
                "logo": "https://media.api-football.com/leagues/1.png",
                "flag": null,
                "standings": 1,
                "is_current": 1,
                "coverage": {
                    "standings": true,
                    "fixtures": {
                        "events": true,
                        "lineups": true,
                        "statistics": true,
                        "players_statistics": false
                    },
                    "players": true,
                    "topScorers": true,
                    "predictions": true,
                    "odds": false
                }
            }
        ]
    }
}

Teams

Data

The {team_id} are unique in the API and teams keep it among all the leagues/cups in which they participate

Parameters

Parameter Type Required Description
team_id integer false Fails if field contains anything other than an integer
league_id integer false Fails if field contains anything other than an integer
search string false 3 characters minimum | Fails if field has anything other than alphabetic characters

Requests

GET By id

Get one team from one {team_id}

get("https://api-football-v1.p.rapidapi.com/v2/teams/team/{team_id}");

GET By league

Get all teams from one {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/teams/league/{league_id}");

GET By search

Allows you to search for a team in relation to a team {name} or {country}

Spaces must be replaced by underscore for better search performance.
EX : Real madrid => real_madrid

get("https://api-football-v1.p.rapidapi.com/v2/teams/search/{name}");
get("https://api-football-v1.p.rapidapi.com/v2/teams/search/{country}");

Response Model

{
    "api": {
        "results": 5,
        "teams": [
            {
                "team_id": 541,
                "name": "Real Madrid",
                "code": null,
                "logo": "https://media.api-football.com/teams/541.png",
                "country": "Spain",
                "founded": 1902,
                "venue_name": "Estadio Santiago Bernabéu",
                "venue_surface": "grass",
                "venue_address": "Avenida de Concha Espina 1, Chamartín",
                "venue_city": "Madrid",
                "venue_capacity": 85454
            }
        ]
    }
}

Statistics

Teams statistics are updated in real time

Parameters

Parameter Type Required Description
league_id integer true Fails if field contains anything other than an integer
team_id integer true Fails if field contains anything other than an integer
date string false Fails if field does not contain a valid date : [YYYY-MM-DD]

Requests

GET

Get all statistics for a {team_id} in a {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/statistics/{league_id}/{team_id}");

GET With date

Get all statistics for a {team_id} in a {league_id} with a end {date}

get("https://api-football-v1.p.rapidapi.com/v2/statistics/{league_id}/{team_id}/{date}");

Response Model

{
    "api": {
        "results": 1,
        "statistics": {
            "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"
                }
            }
        }
    }
}

Standings

Standings are updated every hours

Return 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…

Parameters

Parameter Type Required Description
league_id integer true Fails if field contains anything other than an integer

Requests

GET By league

Get all Standings from one {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/leagueTable/{league_id}");

Response Model

{
    "api": {
        "results": 1,
        "standings": [
            [
                {
                    "rank": 1,
                    "team_id": 85,
                    "teamName": "Paris Saint Germain",
                    "logo": "https://media.api-football.com/teams/85.png",
                    "group": "Ligue 1",
                    "forme": "DLWLL",
                    "description": "Promotion - Champions League (Group Stage)",
                    "all": {
                        "matchsPlayed": 35,
                        "win": 27,
                        "draw": 4,
                        "lose": 4,
                        "goalsFor": 98,
                        "goalsAgainst": 31
                    },
                    "home": {
                        "matchsPlayed": 18,
                        "win": 16,
                        "draw": 2,
                        "lose": 0,
                        "goalsFor": 59,
                        "goalsAgainst": 10
                    },
                    "away": {
                        "matchsPlayed": 17,
                        "win": 11,
                        "draw": 2,
                        "lose": 4,
                        "goalsFor": 39,
                        "goalsAgainst": 21
                    },
                    "goalsDiff": 67,
                    "points": 85,
                    "lastUpdate": "2019-05-04"
                }
            ]
        ]
    }
}

Fixtures

Rounds

The {round} can be used in endpoint [fixtures] as filters

You can get the current {round} for any league by adding the parameter {current} just after the {league_id}

Parameters

Parameter Type Required Description
league_id integer true Fails if field contains anything other than an integer
current string false Fails if field is not within a predetermined list : [current]

Requests

GET By league

Get all available rounds from one {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/rounds/{league_id}");

GET By league & current

Get current round from one {league}

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/rounds/{league_id}/current");

Response Model

{
"api": {
        "results": 30,
        "fixtures": [
            "Regular_Season_-_1",
            "Regular_Season_-_2",
            "Regular_Season_-_3",
            "Regular_Season_-_4",
            "Regular_Season_-_5",
            "Regular_Season_-_6",
            "Regular_Season_-_7",
            "Regular_Season_-_8",
            "Regular_Season_-_9",
            "Regular_Season_-_10",
            "Regular_Season_-_11",
            "Regular_Season_-_12",
            "Regular_Season_-_13",
            "Regular_Season_-_14",
            "Regular_Season_-_15",
            "Regular_Season_-_16",
            "Regular_Season_-_17",
            "Regular_Season_-_18",
            "Regular_Season_-_19",
            "Regular_Season_-_20",
            "Regular_Season_-_21",
            "Regular_Season_-_22",
            "Regular_Season_-_23",
            "Regular_Season_-_24",
            "Regular_Season_-_25",
            "Regular_Season_-_26",
            "Regular_Season_-_27",
            "Regular_Season_-_28",
            "Regular_Season_-_29",
            "Regular_Season_-_30"
        ]
    }
}

fixtures

Fixtures are updated every 15 seconds

Some leagues have only final result check our coverage page to know which ones

For all requests to [fixtures] you can add the query parameter {timezone} to your request in order to retrieve the list of matches in the time zone of your choice like "Europe/London"

To know the list of available time zones you have to use the endpoint [timezone]

Available matches status

  • TBD : Time To Be Defined
  • NS : Not Started
  • 1H : First Half, Kick Off
  • HT : Halftime
  • 2H : Second Half, 2nd Half Started
  • ET : Extra Time
  • P : Penalty In Progress
  • FT : Match Finished
  • AET : Match Finished After Extra Time
  • PEN : Match Finished After Penalty
  • BT : Break Time (in Extra Time)
  • SUSP : Match Suspended
  • INT : Match Interrupted
  • PST : Match Postponed
  • CANC : Match Cancelled
  • ABD : Match Abandoned
  • AWD : Technical Loss
  • WO : WalkOver

Parameters

Parameter Type Required Description
fixture_id integer false Fails if field contains anything other than an integer
league_id integer false Fails if field contains anything other than an integer
team_id integer false Fails if field contains anything other than an integer
live string false Fails if field is not within a predetermined list : [id,id-id..]
date string false Fails if field does not contain a valid date : [YYYY-MM-DD]
round string false Fails if field contains anything other than alpha-numeric characters, numbers, dashes or space
timezone string false Fails if field is not a result of the endpoint timezone

Requests

GET By id

Get fixture from one {fixture_id}

In this request [events], [lineups], [statistics] and [players fixture] are returned in the response

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/id/{fixture_id}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/id/{fixture_id}?timezone=Europe/London");

GET By live

Get all available fixtures in play
In this request [events] are returned in the response

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/live");

GET By live & several leagues

Get all available fixtures in play filter by several {league_id}, the number of leagues is not limited
In this request [events] are returned in the response

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/live/{league_id}-{league_id}-{league_id}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/live/{league_id}-{league_id}-{league_id}?timezone=Europe/London");

GET By date

Get all available from one {date}

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/date/{date}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/date/{date}?timezone=Europe/London");

GET By league

Get all available from one {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/league/{league_id}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/league/{league_id}?timezone=Europe/London");

GET By league & date

Get all available from one {league_id} & {date}

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/league/{league_id}/{date}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/league/{league_id}/{date}?timezone=Europe/London");

GET By league & round

Get all available from one {league_id} & {round}

You can find the available {round} by using the endpoint [rounds]

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/league/{league_id}/{round}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/league/{league_id}/{round}?timezone=Europe/London");

GET By team

Get all available from one {team_id}

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/team/{team_id}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/team/{team_id}?timezone=Europe/London");

GET By team & league

Get all available from one {team_id} & one {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/team/{team_id}/{league_id}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/team/{team_id}/{league_id}?timezone=Europe/London");

Response Model

{
    "api": {
        "results": 380,
        "fixtures": [
            {
                "fixture_id": 65,
                "league_id": 2,
                "league": {
                    "name": "Premier League",
                    "country": "England",
                    "logo": "https://media.api-football.com/leagues/2.png",
                    "flag": "https://media.api-football.com/flags/gb.svg"
                },
                "event_date": "2018-08-10T19:00:00+00:00",
                "event_timestamp": 1533927600,
                "firstHalfStart": 1533927600,
                "secondHalfStart": 1533931200,
                "round": "Regular Season - 1",
                "status": "Match Finished",
                "statusShort": "FT",
                "elapsed": 90,
                "venue": "Old Trafford (Manchester)",
                "referee": null,
                "homeTeam": {
                    "team_id": 33,
                    "team_name": "Manchester United",
                    "logo": "https://media.api-football.com/teams/33.png"
                },
                "awayTeam": {
                    "team_id": 46,
                    "team_name": "Leicester",
                    "logo": "https://media.api-football.com/teams/46.png"
                },
                "goalsHomeTeam": 2,
                "goalsAwayTeam": 1,
                "score": {
                    "halftime": "1-0",
                    "fulltime": "2-1",
                    "extratime": null,
                    "penalty": null
                }
            }
        ]
    }
}

h2h

Parameters

Parameter Type Required Description
team_id string true Fails if field contains anything other than an integer
timezone string false Fails if field is not a result of the endpoint timezone

Requests

GET

Get all head to head between two {team_id}
In this request team comparison and [teams statistics] are also returned in the response

get("https://api-football-v1.p.rapidapi.com/v2/fixtures/h2h/{team_id}/{team_id}");
get("https://api-football-v1.p.rapidapi.com/v2/fixtures/h2h/{team_id}/{team_id}?timezone=Europe/London");

Response Model

{
    "api": {
        "teams": [
            {
                "team_id": 33,
                "team_name": "Manchester United",
                "team_logo": "https://media.api-football.com/teams/33.png",
                "statistics": {
                    "played": {
                        "home": 8,
                        "away": 8,
                        "total": 16
                    },
                    "wins": {
                        "home": 5,
                        "away": 4,
                        "total": 9
                    },
                    "draws": {
                        "home": 2,
                        "away": 2,
                        "total": 4
                    },
                    "loses": {
                        "home": 1,
                        "away": 2,
                        "total": 3
                    }
                }
            },
            {
                "team_id": 34,
                "team_name": "Newcastle",
                "team_logo": "https://media.api-football.com/teams/34.png",
                "statistics": {
                    "played": {
                        "home": 8,
                        "away": 8,
                        "total": 16
                    },
                    "wins": {
                        "home": 2,
                        "away": 1,
                        "total": 3
                    },
                    "draws": {
                        "home": 2,
                        "away": 2,
                        "total": 4
                    },
                    "loses": {
                        "home": 4,
                        "away": 5,
                        "total": 9
                    }
                }
            }
        ],
        "results": 18,
        "fixtures": [
            {
                "fixture_id": 194206,
                "league_id": 701,
                "league": {
                    "name": "Premier League",
                    "country": "England",
                    "logo": "https://media.api-football.com/leagues/56.png",
                    "flag": "https://media.api-football.com/flags/gb.svg"
                },
                "event_date": "2010-08-16T19:00:00+00:00",
                "event_timestamp": 1281985200,
                "firstHalfStart": null,
                "secondHalfStart": null,
                "round": "Regular Season - 38",
                "status": "Match Finished",
                "statusShort": "FT",
                "elapsed": 90,
                "venue": "Old Trafford (Manchester)",
                "referee": null,
                "homeTeam": {
                    "team_id": 33,
                    "team_name": "Manchester United",
                    "logo": "https://media.api-football.com/teams/33.png"
                },
                "awayTeam": {
                    "team_id": 34,
                    "team_name": "Newcastle",
                    "logo": "https://media.api-football.com/teams/34.png"
                },
                "goalsHomeTeam": 3,
                "goalsAwayTeam": 0,
                "score": {
                    "halftime": "2-0",
                    "fulltime": "3-0",
                    "extratime": null,
                    "penalty": null
                }
            }
        ]
    }
}

Statistics

Fixtures statistics are updated every 5 minutes

Available statistics

  • Shots on Goal
  • Shots off Goal
  • Shots insidebox
  • Shots outsidebox
  • Total Shots
  • Blocked Shots
  • Fouls
  • Corner Kicks
  • Offsides
  • Ball Possession
  • Yellow Cards
  • Red Cards
  • Goalkeeper Saves
  • Total passes
  • Passes accurate
  • Passes %

Parameters

Parameter Type Required Description
fixture integer true Fails if field contains anything other than an integer

Requests

GET By fixture

Get all available statistics from one {fixture_id}

get("https://api-football-v1.p.rapidapi.com/v2/statistics/fixture/{fixture_id}");

Response Model

{
    "api": {
        "results": 16,
        "statistics": {
            "Shots on Goal": {
                "home": "5",
                "away": "2"
            },
            "Shots off Goal": {
                "home": "7",
                "away": "4"
            },
            "Total Shots": {
                "home": "17",
                "away": "8"
            },
            "Blocked Shots": {
                "home": "5",
                "away": "2"
            },
            "Shots insidebox": {
                "home": "12",
                "away": "5"
            },
            "Shots outsidebox": {
                "home": "5",
                "away": "3"
            },
            "Fouls": {
                "home": "15",
                "away": "14"
            },
            "Corner Kicks": {
                "home": "9",
                "away": "1"
            },
            "Offsides": {
                "home": "2",
                "away": "2"
            },
            "Ball Possession": {
                "home": "61%",
                "away": "39%"
            },
            "Yellow Cards": {
                "home": "2",
                "away": "3"
            },
            "Red Cards": {
                "home": "",
                "away": ""
            },
            "Goalkeeper Saves": {
                "home": "1",
                "away": "4"
            },
            "Total passes": {
                "home": "633",
                "away": "414"
            },
            "Passes accurate": {
                "home": "575",
                "away": "365"
            },
            "Passes %": {
                "home": "91%",
                "away": "88%"
            }
        }
    }
}

Events

Matches events are updated every 15 seconds

Available events

  • yellow card
  • red card
  • goal
  • own goal
  • penalty
  • missed penalty
  • substitution

Parameters

Parameter Type Required Description
fixture_id integer true Fails if field contains anything other than an integer

Requests

GET By fixture

Get all available events from one {fixture_id}

get("https://api-football-v1.p.rapidapi.com/v2/events/{fixture_id}");

Response Model

{
    "api": {
        "results": 18,
        "events": [
            {
                "elapsed": 25,
                "team_id": 463,
                "teamName": "Aldosivi",
                "player_id": 6126,
                "player": "F. Andrada",
                "assist_id": null,
                "assist": null,
                "type": "Goal",
                "detail": "Normal Goal"
            },
            {
                "elapsed": 44,
                "team_id": 463,
                "teamName": "Aldosivi",
                "player_id": 6262,
                "player": "E. Iniguez",
                "assist_id": null,
                "assist": null,
                "type": "Card",
                "detail": "Yellow Card"
            },
            {
                "elapsed": 46,
                "team_id": 442,
                "teamName": "Defensa Y Justicia",
                "player_id": 5947,
                "player": "B. Merlini",
                "assist_id": 35695,
                "assist": "D. Rodriguez",
                "type": "subst",
                "detail": "D. Rodriguez"
            }
        ]
    }
}

Lineups

Lineups are available between 20 and 40 minutes before the game

Available datas

  • Formation
  • Coach
  • Start XI
  • Substitutes

Parameters

All the parameters of this endpoint can be used together

Parameter Type Required Description
fixture_id integer true Fails if field contains anything other than an integer

Requests

GET By fixture

Get all available lineups from one {fixture_id}

get("https://api-football-v1.p.rapidapi.com/v2/lineups/{fixture_id}");

Response Model

{
    "api": {
        "results": 2,
        "lineUps": {
            "Paris Saint Germain": {
                "formation": "4-2-3-1",
                "startXI": [
                    {
                        "team_id": 85,
                        "player_id": 253,
                        "player": "Alphonse Aréola",
                        "number": 16,
                        "pos": "G"
                    },
                    {
                        "team_id": 85,
                        "player_id": 256,
                        "player": "Dani Alves",
                        "number": 13,
                        "pos": "M"
                    },
                    {
                        "team_id": 85,
                        "player_id": 257,
                        "player": "Marquinhos",
                        "number": 5,
                        "pos": "D"
                    },
                    {
                        "team_id": 85,
                        "player_id": 262,
                        "player": "Presnel Kimpembe",
                        "number": 3,
                        "pos": "D"
                    },
                    {
                        "team_id": 85,
                        "player_id": 258,
                        "player": "Juan Bernat",
                        "number": 14,
                        "pos": "D"
                    },
                    {
                        "team_id": 85,
                        "player_id": 271,
                        "player": "Leandro Paredes",
                        "number": 8,
                        "pos": "M"
                    },
                    {
                        "team_id": 85,
                        "player_id": 273,
                        "player": "Marco Verratti",
                        "number": 6,
                        "pos": "M"
                    },
                    {
                        "team_id": 85,
                        "player_id": 267,
                        "player": "Julian Draxler",
                        "number": 23,
                        "pos": "M"
                    },
                    {
                        "team_id": 85,
                        "player_id": 276,
                        "player": "Neymar",
                        "number": 10,
                        "pos": "F"
                    },
                    {
                        "team_id": 85,
                        "player_id": 266,
                        "player": "Ángel Di María",
                        "number": 11,
                        "pos": "F"
                    },
                    {
                        "team_id": 85,
                        "player_id": 274,
                        "player": "Edinson Cavani",
                        "number": 9,
                        "pos": "F"
                    }
                ],
                "substitutes": [
                    {
                        "team_id": 85,
                        "player_id": 254,
                        "player": "Gianluigi Buffon",
                        "number": 1,
                        "pos": "G"
                    },
                    {
                        "team_id": 85,
                        "player_id": 265,
                        "player": "Arthur Zagre",
                        "number": 33,
                        "pos": "D"
                    },
                    {
                        "team_id": 85,
                        "player_id": null,
                        "player": "Loic Mbe Soh",
                        "number": 36,
                        "pos": "D"
                    },
                    {
                        "team_id": 85,
                        "player_id": 260,
                        "player": "Colin Dagba",
                        "number": 31,
                        "pos": "D"
                    },
                    {
                        "team_id": 85,
                        "player_id": 263,
                        "player": "Layvin Kurzawa",
                        "number": 20,
                        "pos": "D"
                    },
                    {
                        "team_id": 85,
                        "player_id": 277,
                        "player": "Moussa Diaby",
                        "number": 27,
                        "pos": "M"
                    },
                    {
                        "team_id": 85,
                        "player_id": 269,
                        "player": "Christopher Nkunku",
                        "number": 24,
                        "pos": "M"
                    }
                ]
            },
            "Nice": {
                "formation": "4-3-3",
                "startXI": [
                    {
                        "team_id": 84,
                        "player_id": 22157,
                        "player": "Walter Benítez",
                        "number": 40,
                        "pos": "G"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22161,
                        "player": "Patrick Burner",
                        "number": 15,
                        "pos": "D"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22164,
                        "player": "Christophe Herelle",
                        "number": 29,
                        "pos": "D"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22163,
                        "player": "Dante",
                        "number": 31,
                        "pos": "D"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22166,
                        "player": "Malang Sarr",
                        "number": 23,
                        "pos": "D"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22170,
                        "player": "Pierre Lees Melou",
                        "number": 8,
                        "pos": "M"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22174,
                        "player": "Adrien Tameze",
                        "number": 5,
                        "pos": "M"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22167,
                        "player": "Danilo",
                        "number": 21,
                        "pos": "M"
                    },
                    {
                        "team_id": 84,
                        "player_id": 3165,
                        "player": "Youcef Atal",
                        "number": 20,
                        "pos": "M"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22173,
                        "player": "Allan Saint-Maximin",
                        "number": 7,
                        "pos": "F"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22177,
                        "player": "Igniatius Ganago",
                        "number": 14,
                        "pos": "F"
                    }
                ],
                "substitutes": [
                    {
                        "team_id": 84,
                        "player_id": 22159,
                        "player": "Yannis Clementia",
                        "number": 16,
                        "pos": "G"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22160,
                        "player": "Olivier Boscagli",
                        "number": 28,
                        "pos": "D"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22171,
                        "player": "Jean-Victor Makengo",
                        "number": 27,
                        "pos": "M"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22172,
                        "player": "Ihsan Sacko",
                        "number": 18,
                        "pos": "M"
                    },
                    {
                        "team_id": 84,
                        "player_id": 2959,
                        "player": "Bassem Srarfi",
                        "number": 11,
                        "pos": "F"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22178,
                        "player": "Mickaël Le Bihan",
                        "number": 10,
                        "pos": "F"
                    },
                    {
                        "team_id": 84,
                        "player_id": 22176,
                        "player": "Assil Jaziri",
                        "number": 33,
                        "pos": "SUB"
                    }
                ]
            }
        }
    }
}

Predictions

Get several predictions about a match. The predictions are made using several algorithms including the fish law, comparison of team statistics, last matches, players etc…

Bookmaker odds are not used to make these predictions

Also provides some comparative statistics between teams

Available Predictions

  • Match winner : 1 / 1N / N / N2 / 2
  • Under / Over : -1.5 / -2.5 / -3.5 / -4.5 / +1.5 / +2.5 / +3.5 / +4.5
  • Goals Home : -1.5 / -2.5 / -3.5 / -4.5
  • Goals Away -1.5 / -2.5 / -3.5 / -4.5
  • Advice

Parameters

Parameter Type Required Description
fixture_id integer true Fails if field contains anything other than an integer

Requests

GET By fixture

Get all available predictions from one {fixture_id}

get("https://api-football-v1.p.rapidapi.com/v2/predictions/{fixture_id}");

Response Model

{
    "api": {
        "results": 1,
        "predictions": [
            {
                "match_winner": "1",
                "under_over": null,
                "goals_home": "-3.5",
                "goals_away": "-1.5",
                "advice": "Winner : Paris Saint Germain",
                "winning_percent": {
                    "home": "50%",
                    "draws": "50%",
                    "away": "0%"
                },
                "teams": {
                    "home": {
                        "team_id": 85,
                        "team_name": "Paris Saint Germain",
                        "last_5_matches": {
                            "forme": "75%",
                            "att": "71%",
                            "def": "86%",
                            "goals": 10,
                            "goals_avg": 2.5,
                            "goals_against": 2,
                            "goals_against_avg": 0.5
                        },
                        "all_last_matches": {
                            "matchs": {
                                "matchsPlayed": {
                                    "home": 3,
                                    "away": 2,
                                    "total": 5
                                },
                                "wins": {
                                    "home": 3,
                                    "away": 1,
                                    "total": 4
                                },
                                "draws": {
                                    "home": 0,
                                    "away": 0,
                                    "total": 0
                                },
                                "loses": {
                                    "home": 0,
                                    "away": 1,
                                    "total": 1
                                }
                            },
                            "goals": {
                                "goalsFor": {
                                    "home": 8,
                                    "away": 3,
                                    "total": 11
                                },
                                "goalsAgainst": {
                                    "home": 0,
                                    "away": 2,
                                    "total": 2
                                }
                            },
                            "goalsAvg": {
                                "goalsFor": {
                                    "home": "2.7",
                                    "away": "1.5",
                                    "total": "2.2"
                                },
                                "goalsAgainst": {
                                    "home": "0.0",
                                    "away": "1.0",
                                    "total": "0.4"
                                }
                            }
                        },
                        "last_h2h": {
                            "played": {
                                "home": 4,
                                "away": 3,
                                "total": 7
                            },
                            "wins": {
                                "home": 3,
                                "away": 1,
                                "total": 4
                            },
                            "draws": {
                                "home": 1,
                                "away": 1,
                                "total": 2
                            },
                            "loses": {
                                "home": 0,
                                "away": 1,
                                "total": 1
                            }
                        }
                    },
                    "away": {
                        "team_id": 95,
                        "team_name": "Strasbourg",
                        "last_5_matches": {
                            "forme": "25%",
                            "att": "21%",
                            "def": "64%",
                            "goals": 3,
                            "goals_avg": 0.75,
                            "goals_against": 5,
                            "goals_against_avg": 1.25
                        },
                        "all_last_matches": {
                            "matchs": {
                                "matchsPlayed": {
                                    "home": 3,
                                    "away": 2,
                                    "total": 5
                                },
                                "wins": {
                                    "home": 0,
                                    "away": 0,
                                    "total": 0
                                },
                                "draws": {
                                    "home": 2,
                                    "away": 1,
                                    "total": 3
                                },
                                "loses": {
                                    "home": 1,
                                    "away": 1,
                                    "total": 2
                                }
                            },
                            "goals": {
                                "goalsFor": {
                                    "home": 3,
                                    "away": 0,
                                    "total": 3
                                },
                                "goalsAgainst": {
                                    "home": 5,
                                    "away": 1,
                                    "total": 6
                                }
                            },
                            "goalsAvg": {
                                "goalsFor": {
                                    "home": "1.0",
                                    "away": "0.0",
                                    "total": "0.6"
                                },
                                "goalsAgainst": {
                                    "home": "1.7",
                                    "away": "0.5",
                                    "total": "1.2"
                                }
                            }
                        },
                        "last_h2h": {
                            "played": {
                                "home": 3,
                                "away": 4,
                                "total": 7
                            },
                            "wins": {
                                "home": 1,
                                "away": 0,
                                "total": 1
                            },
                            "draws": {
                                "home": 1,
                                "away": 1,
                                "total": 2
                            },
                            "loses": {
                                "home": 1,
                                "away": 3,
                                "total": 4
                            }
                        }
                    }
                },
                "h2h": [
                    {
                        "fixture_id": 35755,
                        "league_id": 22,
                        "league": {
                            "name": "Ligue 1",
                            "country": "France",
                            "logo": "https://media.api-football.com/leagues/22.svg",
                            "flag": "https://media.api-football.com/flags/fr.svg"
                        },
                        "event_date": "2017-12-02T16:00:00+00:00",
                        "event_timestamp": 1512230400,
                        "firstHalfStart": 1512230400,
                        "secondHalfStart": 1512234000,
                        "round": "Regular Season - 16",
                        "status": "Match Finished",
                        "statusShort": "FT",
                        "elapsed": 90,
                        "venue": "Stade de la Meinau (Strasbourg)",
                        "referee": "R. Buquet",
                        "homeTeam": {
                            "team_id": 95,
                            "team_name": "Strasbourg",
                            "logo": "https://media.api-football.com/teams/95.png"
                        },
                        "awayTeam": {
                            "team_id": 85,
                            "team_name": "Paris Saint Germain",
                            "logo": "https://media.api-football.com/teams/85.png"
                        },
                        "goalsHomeTeam": 2,
                        "goalsAwayTeam": 1,
                        "score": {
                            "halftime": "1-1",
                            "fulltime": "2-1",
                            "extratime": null,
                            "penalty": null
                        }
                    }
                ],
                "comparison": {
                    "forme": {
                        "home": "75%",
                        "away": "25%"
                    },
                    "att": {
                        "home": "77%",
                        "away": "23%"
                    },
                    "def": {
                        "home": "71%",
                        "away": "29%"
                    },
                    "fish_law": {
                        "home": "0%",
                        "away": "0%"
                    },
                    "h2h": {
                        "home": "85%",
                        "away": "15%"
                    },
                    "goals_h2h": {
                        "home": "67%",
                        "away": "33%"
                    }
                }
            }
        ]
    }
}

Coachs

Get all the information about the coachs and their careers

Parameters

All the parameters of this endpoint can be used together

Parameter Type Required Description
coach_id integer false Fails if field contains anything other than an integer
team_id integer false Fails if field contains anything other than an integer
search string false 3 characters minimum | Fails if field has anything other than alphabetic characters

Requests

GET By id

Get coachs from one {coach_id}

get("https://api-football-v1.p.rapidapi.com/v2/coachs/coach/{coach_id}");

GET By team

Get coachs from one {team_id}

get("https://api-football-v1.p.rapidapi.com/v2/coachs/team/{team_id}");

GET By search

Allows you to search for a coach in relation to a coach {name}

get("https://api-football-v1.p.rapidapi.com/v2/coachs/search/{name}");

Response Model

{
    "api": {
        "results": 1,
        "coachs": [
            {
                "id": 18,
                "name": "Unai Emery",
                "firstname": "Unai",
                "lastname": "Emery Etxegoien",
                "age": 48,
                "birth_date": "03/11/1971",
                "birth_place": "Hondarribia",
                "birth_country": "Spain",
                "nationality": "Spain",
                "height": null,
                "weight": null,
                "team": {
                    "id": 42,
                    "name": "Arsenal"
                },
                "career": [
                    {
                        "team": {
                            "id": 42,
                            "name": "Arsenal"
                        },
                        "start": "23/05/2018",
                        "end": null
                    },
                    {
                        "team": {
                            "id": 85,
                            "name": "PSG"
                        },
                        "start": "28/06/2016",
                        "end": "23/05/2018"
                    },
                    {
                        "team": {
                            "id": 536,
                            "name": "Sevilla"
                        },
                        "start": "15/01/2013",
                        "end": "12/06/2016"
                    },
                    {
                        "team": {
                            "id": 558,
                            "name": "Spartak Moskva"
                        },
                        "start": "10/06/2012",
                        "end": "25/11/2012"
                    },
                    {
                        "team": {
                            "id": 532,
                            "name": "Valencia"
                        },
                        "start": "01/07/2008",
                        "end": "10/06/2012"
                    },
                    {
                        "team": {
                            "id": 723,
                            "name": "Almería"
                        },
                        "start": "01/07/2006",
                        "end": "30/06/2008"
                    },
                    {
                        "team": {
                            "id": null,
                            "name": "Lorca Deportiva CF"
                        },
                        "start": "01/11/2004",
                        "end": "30/06/2006"
                    }
                ]
            }
        ]
    }
}

Players

Seasons

The {season} returned by this endpoint are only available for [players] endpoint

Parameters

This endpoint does not require any parameters

Requests

GET all

Get all available {season} for players statistics

get("https://api-football-v1.p.rapidapi.com/v2/players/seasons");

Response Model

{
    "api": {
        "results": 44,
        "players": [
            "1993",
            "1996",
            "1999",
            "2000",
            "2001",
            "2001-2002",
            "2002",
            "2002-2003",
            "2003",
            "2003-2004",
            "2004",
            "2004-2005",
            "2005",
            "2005-2006",
            "2006",
            "2006-2007",
            "2007",
            "2007-2008",
            "2008",
            "2008-2009",
            "2009",
            "2009-2010",
            "2010",
            "2010-2011",
            "2011",
            "2011-2012",
            "2012",
            "2012-2013",
            "2013",
            "2013-2014",
            "2014",
            "2014-2015",
            "2015",
            "2015-2016",
            "2016",
            "2016-2017",
            "2017",
            "2017-2018",
            "2018",
            "2018-2019",
            "2019",
            "2019-2020",
            "2020"
        ]
    }
}

Top scorers

Topscorers are updated once a day

The {player_id} are unique in the API and players keep it among all the teams they have been in

How it is calculated:

  • 1 : The player that has scored the fewer number of penalties
  • 2 : The player that has delivered the higher number of goal assists
  • 3 : The player that scored their goals in the greater number of matches
  • 4 : The player that played the fewer minutes
  • 5 : The player that plays for the team placed higher on the table
  • 6 : The player that received fewer red cards
  • 7 : The player that received fewer yellow cards

Parameters

Parameter Type Required Description
league_id integer true Fails if field contains anything other than an integer

Requests

GET By league

Get the 20 best players from a {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/topscorers/{league_id}");

Response Model

{
    "api": {
        "results": 20,
        "topscorers": [
            {
                "player_id": 278,
                "player_name": "K. Mbappé",
                "firstname": "Kylian",
                "lastname": "Mbappé Lottin",
                "position": "Attacker",
                "nationality": "France",
                "team_id": 85,
                "team_name": "Paris Saint Germain",
                "games": {
                    "appearences": 29,
                    "minutes_played": 2340
                },
                "goals": {
                    "total": 33,
                    "assists": 7,
                    "conceded": null
                },
                "shots": {
                    "total": 122,
                    "on": 68
                },
                "penalty": {
                    "won": 3,
                    "commited": null,
                    "success": 1,
                    "missed": 0,
                    "saved": null
                },
                "cards": {
                    "yellow": 5,
                    "second_yellow": 0,
                    "red": 1
                }
            },
            {
                "player_id": 3246,
                "player_name": "N. Pépé",
                "firstname": "Nicolas",
                "lastname": "Pépé",
                "position": "Attacker",
                "nationality": "Côte d'Ivoire",
                "team_id": 79,
                "team_name": "Lille",
                "games": {
                    "appearences": 38,
                    "minutes_played": 3332
                },
                "goals": {
                    "total": 22,
                    "assists": 11,
                    "conceded": null
                },
                "shots": {
                    "total": 118,
                    "on": 61
                },
                "penalty": {
                    "won": 5,
                    "commited": null,
                    "success": 9,
                    "missed": 1,
                    "saved": null
                },
                "cards": {
                    "yellow": 1,
                    "second_yellow": 0,
                    "red": 0
                }
            }
        ]
    }
}

Squad

Players squad are updated once a day

The {player_id} are unique in the API and players keep it among all the teams they have been in

Parameters

Parameter Type Required Description
team_id integer false Fails if field contains anything other than an integer
season string false Fails if field contains anything other than numeric characters or dashes [YYYY] or [YYYY-YYYY]

Requests

GET

Get all players for one {team_id} and {season}

You can find the available {season} by using the endpoint [players seasons]

get("https://api-football-v1.p.rapidapi.com/v2/players/squad/{team_id}/{season}");

Response Model

{
    "api": {
        "results": 33,
        "players": [
            {
                "player_id": 272,
                "player_name": "Adrien Rabiot",
                "firstname": "Adrien",
                "lastname": "Rabiot",
                "number": null,
                "position": "Midfielder",
                "age": 24,
                "birth_date": "03/04/1995",
                "birth_place": "Saint-Maurice",
                "birth_country": "France",
                "nationality": "France",
                "height": "188 cm",
                "weight": "71 kg"
            },
            {
                "player_id": 85062,
                "player_name": "Thiago Motta",
                "firstname": "Thiago",
                "lastname": "Motta",
                "number": null,
                "position": "Midfielder",
                "age": 36,
                "birth_date": "28/08/1982",
                "birth_place": "São Bernardo do Campo",
                "birth_country": "Brazil",
                "nationality": "Italy",
                "height": "187 cm",
                "weight": "83 kg"
            },
            {
                "player_id": 254,
                "player_name": "Gianluigi Buffon",
                "firstname": "Gianluigi",
                "lastname": "Buffon",
                "number": null,
                "position": "Goalkeeper",
                "age": 41,
                "birth_date": "28/01/1978",
                "birth_place": "Carrara",
                "birth_country": "Italy",
                "nationality": "Italy",
                "height": "192 cm",
                "weight": "92 kg"
            },
            {
                "player_id": 273,
                "player_name": "Marco Verratti",
                "firstname": "Marco",
                "lastname": "Verratti",
                "number": null,
                "position": "Midfielder",
                "age": 27,
                "birth_date": "05/11/1992",
                "birth_place": "Pescara",
                "birth_country": "Italy",
                "nationality": "Italy",
                "height": "165 cm",
                "weight": "60 kg"
            }
        ]
    }
}

Statistics Seasons

Players statistics are updated once a day

The {player_id} are unique in the API and players keep it among all the teams they have been in

The return can contain several results for the same {player_id} because the statistics are calculated according to the {team_id}, {league_id} and {season}

Parameters

Parameter Type Required Description
player_id integer false Fails if field contains anything other than an integer
team_id integer false Fails if field contains anything other than an integer
season string false Fails if field contains anything other than numeric characters or dashes [YYYY] or [YYYY-YYYY]

Requests

GET By id

Get all players statistics from one {player_id}

get("https://api-football-v1.p.rapidapi.com/v2/players/player/{player_id}");

GET By id & season

Get all players statistics from one {player_id} and {season}

You can find the available {season} by using the endpoint [players seasons]

get("https://api-football-v1.p.rapidapi.com/v2/players/player/{player_id}/{season}");

GET By team

Get all players statistics from one {team_id}

get("https://api-football-v1.p.rapidapi.com/v2/players/team/{team_id}");

GET By team & season

Get all players statistics from one {team_id} & {season}

You can find the available {season} by using the endpoint [players seasons]

get("https://api-football-v1.p.rapidapi.com/v2/players/team/{team_id}/{season}");

Response Model

{
    "api": {
        "results": 3,
        "players": [
            {
                "player_id": 276,
                "player_name": "Neymar da Silva Santos Junior",
                "firstname": "Neymar",
                "lastname": "da Silva Santos Junior",
                "number": 10,
                "position": "Attacker",
                "age": 27,
                "birth_date": "05/02/1992",
                "birth_place": "Mogi das Cruzes",
                "birth_country": "Brazil",
                "nationality": "Brazil",
                "height": "175 cm",
                "weight": "68 kg",
                "injured": "False",
                "rating": "8.183333",
                "team_id": 85,
                "team_name": "Paris Saint Germain",
                "league": "UEFA Champions League",
                "season": "2018-2019",
                "captain": 0,
                "shots": {
                    "total": 24,
                    "on": 16
                },
                "goals": {
                    "total": 5,
                    "conceded": 0,
                    "assists": 2
                },
                "passes": {
                    "total": 262,
                    "key": 0,
                    "accuracy": 82
                },
                "tackles": {
                    "total": 3,
                    "blocks": 2,
                    "interceptions": 2
                },
                "duels": {
                    "total": 122,
                    "won": 72
                },
                "dribbles": {
                    "attempts": 54,
                    "success": 32
                },
                "fouls": {
                    "drawn": 34,
                    "committed": 4
                },
                "cards": {
                    "yellow": 2,
                    "yellowred": 0,
                    "red": 0
                },
                "penalty": {
                    "won": 0,
                    "commited": 0,
                    "success": 0,
                    "missed": 0,
                    "saved": 0
                },
                "games": {
                    "appearences": 6,
                    "minutes_played": 532,
                    "lineups": 6
                },
                "substitutes": {
                    "in": 0,
                    "out": 1,
                    "bench": 0
                }
            },
        ]
    }
}

Statistics fixtures

Players statistics fixtures are updated every 5 minutes

This is a new endpoint, data start from season 2018 we will add the history gradually

Parameters

Parameter Type Required Description
fixture_id integer true Fails if field contains anything other than an integer

Requests

GET By fixture

Get all players statistics from one {fixture_id}

get("https://api-football-v1.p.rapidapi.com/v2/players/fixture/{fixture_id}");

Response Model

{
    "api": {
        "results": 28,
        "players": [
            {
                "event_id": 169080,
                "updateAt": 1564390756,
                "player_id": 35931,
                "player_name": "Sebastián Sosa",
                "team_id": 2284,
                "team_name": "Monarcas",
                "number": 13,
                "position": "G",
                "rating": "6.2",
                "minutes_played": 90,
                "captain": "False",
                "substitute": "False",
                "offsides": null,
                "shots": {
                    "total": 0,
                    "on": 0
                },
                "goals": {
                    "total": 0,
                    "conceded": 1,
                    "assists": 0
                },
                "passes": {
                    "total": 16,
                    "key": 0,
                    "accuracy": 64
                },
                "tackles": {
                    "total": 0,
                    "blocks": 0,
                    "interceptions": 0
                },
                "duels": {
                    "total": 0,
                    "won": 0
                },
                "dribbles": {
                    "attempts": 0,
                    "success": 0,
                    "past": 0
                },
                "fouls": {
                    "drawn": 0,
                    "committed": 0
                },
                "cards": {
                    "yellow": 0,
                    "red": 0
                },
                "penalty": {
                    "won": 0,
                    "commited": 0,
                    "success": 0,
                    "missed": 0,
                    "saved": 0
                }
            },
            {
                "event_id": 169080,
                "updateAt": 1564390756,
                "player_id": 35661,
                "player_name": "Joaquín Martínez",
                "team_id": 2284,
                "team_name": "Monarcas",
                "number": 23,
                "position": "D",
                "rating": "6.9",
                "minutes_played": 90,
                "captain": "False",
                "substitute": "False",
                "offsides": null,
                "shots": {
                    "total": 0,
                    "on": 0
                },
                "goals": {
                    "total": 0,
                    "conceded": 0,
                    "assists": 0
                },
                "passes": {
                    "total": 11,
                    "key": 1,
                    "accuracy": 68
                },
                "tackles": {
                    "total": 1,
                    "blocks": 0,
                    "interceptions": 0
                },
                "duels": {
                    "total": 8,
                    "won": 7
                },
                "dribbles": {
                    "attempts": 1,
                    "success": 1,
                    "past": 0
                },
                "fouls": {
                    "drawn": 0,
                    "committed": 0
                },
                "cards": {
                    "yellow": 0,
                    "red": 0
                },
                "penalty": {
                    "won": 0,
                    "commited": 0,
                    "success": 0,
                    "missed": 0,
                    "saved": 0
                }
            }
        ]
    }
}

Transfers

Transfers are updated once a day

Parameters

Parameter Type Required Description
player integer false Fails if field contains anything other than an integer
team integer false Fails if field contains anything other than an integer

Requests

GET By player

Get all transfers from one {player_id}

get("https://api-football-v1.p.rapidapi.com/v2/transfers/player/{player_id}");

GET By team

Get all transfers from one {team_id}

get("https://api-football-v1.p.rapidapi.com/v2/transfers/team/{team_id}");

Response Model

{
    "api": {
        "results": 1,
        "transfers": [
            {
                "player_id": 19018,
                "player_name": "Timothy Evans Fosu-Mensah",
                "transfer_date": "2019-07-01",
                "type": null,
                "team_in": {
                    "team_id": 33,
                    "team_name": "Manchester United"
                },
                "team_out": {
                    "team_id": 36,
                    "team_name": "Fulham"
                },
                "lastUpdate": 1561726193
            }
        ]
    }
}

Odds

bookmakers

All {bookmaker_id} can be used in endpoint [odds] as filters

Parameters

Parameter Type Required Description
bookmaker_id integer false Fails if field contains anything other than an integer

Requests

GET all

Get all available bookmakers

get("https://api-football-v1.p.rapidapi.com/v2/odds/bookmakers/");

GET By Id

Get bookmaker from one {bookmaker_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/bookmakers/{bookmaker_id}");

Response Model

{
    "api": {
        "results": 9,
        "bookmakers": [
            {
                "id": 1,
                "name": "10Bet"
            },
            {
                "id": 2,
                "name": "Marathonbet"
            },
            {
                "id": 3,
                "name": "Betfair"
            },
            {
                "id": 4,
                "name": "Pinnacle"
            },
            {
                "id": 5,
                "name": "Sport Betting Odds"
            },
            {
                "id": 6,
                "name": "Bwin"
            },
            {
                "id": 7,
                "name": "William Hill"
            },
            {
                "id": 8,
                "name": "Bet365"
            },
            {
                "id": 9,
                "name": "Dafabet"
            }
        ]
    }
}

labels

All {label_id} can be used in endpoint [odds] as filters

Parameters

Parameter Type Required Description
label_id integer false Fails if field contains anything other than an integer

Requests

GET all

Get all available labels

get("https://api-football-v1.p.rapidapi.com/v2/odds/labels/");

GET By Id

Get labels from one {label_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/labels/{label_id}");

Response Model

{
    "api": {
        "results": 61,
        "labels": [
            {
                "id": 1,
                "label": "Match Winner"
            },
            {
                "id": 2,
                "label": "Home/Away"
            },
            {
                "id": 3,
                "label": "Second Half Winner"
            },
            {
                "id": 4,
                "label": "Asian Handicap"
            },
            {
                "id": 5,
                "label": "Goals Over/Under"
            },
            {
                "id": 6,
                "label": "Goals Over/Under First Half"
            }
        ]
    }
}

odds

Odds are updated once a day

We provide pre-match odds between 1 and 7 days before the game We are currently working on a feature to provide real-time odds

We keep a 7-day history
(Some competitions do not have this feature)

Parameters

Parameter Type Required Description
fixture_id integer false Fails if field contains anything other than an integer
league_id integer false Fails if field contains anything other than an integer
bookmaker_id integer false Fails if field contains anything other than an integer
label_id integer false Fails if field contains anything other than an integer

Requests

GET By fixture

Get all available odds from one {fixture_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/fixture/{fixture_id}");

GET By fixture & bookmaker

Get all available odds from one {fixture_id} & {bookmaker_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/fixture/{fixture_id}/bookmaker/{bookmaker_id}");

GET By fixture & label

Get all available odds from one {fixture_id} & {label_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/fixture/{fixture_id}/label/{label_id}");

GET By league

Get all available odds from one {league_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/league/{league_id}");

GET By league & bookmaker

Get all available odds from one {league_id} & {bookmaker_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/league/{league_id}/bookmaker/{bookmaker_id}");

GET By league & label

Get all available odds from one {league_id} & {label_id}

get("https://api-football-v1.p.rapidapi.com/v2/odds/league/{league_id}/label/{label_id}");

Response Model

{
    "api": {
        "results": 1,
        "odds": [
            {
                "fixture": {
                    "league_id": 404,
                    "fixture_id": 108705,
                    "updateAt": 1557496046
                },
                "bookmakers": [
                    {
                        "bookmaker_id": 6,
                        "bookmaker_name": "bwin",
                        "bets": [
                            {
                                "label_id": 1,
                                "label_name": "Match Winner",
                                "values": [
                                    {
                                        "value": "Home",
                                        "odd": "2.20"
                                    },
                                    {
                                        "value": "Draw",
                                        "odd": "3.70"
                                    },
                                    {
                                        "value": "Away",
                                        "odd": "2.60"
                                    }
                                ]
                            },
                            {
                                "label_id": 8,
                                "label_name": "Both Teams To Score",
                                "values": [
                                    {
                                        "value": "Yes",
                                        "odd": "1.40"
                                    },
                                    {
                                        "value": "No",
                                        "odd": "2.75"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "bookmaker_id": 1,
                        "bookmaker_name": "10Bet",
                        "bets": [
                            {
                                "label_id": 1,
                                "label_name": "Match Winner",
                                "values": [
                                    {
                                        "value": "Home",
                                        "odd": "2.30"
                                    },
                                    {
                                        "value": "Draw",
                                        "odd": "3.60"
                                    },
                                    {
                                        "value": "Away",
                                        "odd": "2.50"
                                    }
                                ]
                            },
                            {
                                "label_id": 2,
                                "label_name": "Home/Away",
                                "values": [
                                    {
                                        "value": "Home",
                                        "odd": "1.77"
                                    },
                                    {
                                        "value": "Away",
                                        "odd": "1.83"
                                    }
                                ]
                            }
                        }
                    }
                ]
            }
        ]
    }
}

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication