logo
theme
Api-Football-Beta
FREEMIUM
By api-sports
Updated 3 days ago
Api-Football-Beta Overview
Beta Program for api-football. Here you can test the next version of the API. To register you must send us an email to [email protected] it is not recommended to use this version for a site or application in production (unless you want review the code each time we will modify something). For production USE : https://rapidapi.com/api-sports/api/api-football
provider
rating
add first rating
Followers on API
Follow this API
resourcesProvider WebsiteTerms of Service
More Details

API-FOOTBALL

Introduction

Welcome to Api-Football! You can use our API to access all API endpoints, which can get information about Football Leagues & Cups.

Authentication

Beta Program

To participate in the Beta program and use this version of the API, you must send us an email to [email protected] with your username on rapidApi.
From the reception we will register you for the Beta version and you will only have to go to the pricing page and subscribe to the “CUSTOM-BETA“ plan (Free plan with 5 000 requests/day)

We uses API keys to allow access to the API. You can register a new API key in rapidapi.

Architecture

Version: 3.4.9

Contact information:
https://www.api-football.com/documentation-beta
https://apifootball.freshdesk.com/

/timezone

GET

Summary:

Timezone

Description:

Get the list of available timezone to be used in the fixtures endpoint.
> This endpoint does not require any parameters.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
get('https://api-football-beta.p.rapidapi.com/timezone');
Responses
Code Description
200 OK
{
 "get": "timezone",
 "parameters": [],
 "errors": [],
 "results": 425,
 "response": [
   "Africa/Abidjan",
   "Africa/Accra",
   "Africa/Addis_Ababa",
   "Africa/Algiers",
   "Africa/Asmara"
 ]
}

/countries

GET

Summary:

Countries

Description:

Get the list of available countries.
The name and code fields can be used in other endpoints as filters.
> Examples available in Request samples "Use Cases".
> All the parameters of this endpoint can be used together.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
name query The name of the country No string
code query The Alpha2 code of the country No string
search query The name of the country No string
// Get all available countries across all {seasons} and competitions
get("https://api-football-beta.p.rapidapi.com/countries");
// Get all available countries from one country {name}
get("https://api-football-beta.p.rapidapi.com/countries?name=england");
// Get all available countries from one country {code}
get("https://api-football-beta.p.rapidapi.com/countries?code=fr");
// Allows you to search for a countries in relation to a country {name}
get("https://api-football-beta.p.rapidapi.com/countries?search=engl");
Responses
Code Description
200 OK
{
 "get": "countries",
 "parameters": {
   "name": "england"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "name": "England",
     "code": "GB",
     "flag": "https://media.api-football.com/flags/gb.svg"
   }
 ]
}

/leagues/seasons

GET

Summary:

Seasons

Description:

All seasons are only 4-digit keys, so for a league whose season is 2018-2019 like the English Premier League (EPL), the 2018-2019 season in the API will be 2018.
All seasons can be used in other endpoints as filters.
> This endpoint does not require any parameters.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
get("https://api-football-beta.p.rapidapi.com/leagues/seasons");
Responses
Code Description
200 OK
{
 "get": "leagues/seasons",
 "parameters": [],
 "errors": [],
 "results": 12,
 "response": [
   2008,
   2010,
   2011,
   2012,
   2013,
   2014,
   2015,
   2016,
   2017,
   2018,
   2019,
   2020
 ]
}

/leagues

GET

Summary:

Leagues

Description:

Get the list of available leagues and cups.
The league id are unique in the API and leagues keep it across all seasons
> Examples available in Request samples "Use Cases".
> Most of the parameters of this endpoint can be used together.
Leagues data are updated several times a day

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
id query The id of the league No integer
name query The name of the league No string
country query The country name of the league No string
code query The Alpha2 code of the country No string
season query The season of the league No integer
team query The id of the team No integer
type query The type of the league No string
current query The state of the league No string
search query The name or the country of the league No string
// Allows to retrieve all the seasons available for a league/cup
get("https://api-football-beta.p.rapidapi.com/leagues?id=39");
// Get all leagues from one league {name}
get("https://api-football-beta.p.rapidapi.com/leagues?name=premier league");
// Get all leagues from one {country}
// You can find the available {country} by using the endpoint country
get("https://api-football-beta.p.rapidapi.com/leagues?country=england");
// 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-beta.p.rapidapi.com/leagues?code=gb");
// Get all leagues from one {season}
// You can find the available {season} by using the endpoint seasons
get("https://api-football-beta.p.rapidapi.com/leagues?season=2019");
// Get one league from one league {id} & {season}
get("https://api-football-beta.p.rapidapi.com/leagues?season=2019&id=39");
// Get all leagues in which the {team} has played at least one match
get("https://api-football-beta.p.rapidapi.com/leagues?team=33");
// Allows you to search for a league in relation to a league {name} or {country}
get("https://api-football-beta.p.rapidapi.com/leagues?search=premier league");
get("https://api-football-beta.p.rapidapi.com/leagues?search=England");
// Get all leagues from one {type}
get("https://api-football-beta.p.rapidapi.com/leagues?type=league");
// Get all leagues where the season is in progress or not
get("https://api-football-beta.p.rapidapi.com/leagues?current=true");
// It’s possible to make requests by mixing the available parameters
get("https://api-football-beta.p.rapidapi.com/leagues?season=2019&country=england&type=league");
get("https://api-football-beta.p.rapidapi.com/leagues?team=85&season=2019");
get("https://api-football-beta.p.rapidapi.com/leagues?id=61¤t=true&type=league");
Responses
Code Description
200 OK
{
 "get": "leagues",
 "parameters": {
   "id": "39"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "league": {
       "id": 39,
       "name": "Premier League",
       "type": "League",
       "logo": "https://media.api-football.com/leagues/2.png"
     },
     "country": {
       "name": "England",
       "code": "GB",
       "flag": "https://media.api-football.com/flags/gb.svg"
     },
     "seasons": [
       {
         "year": 2010,
         "start": "2010-08-14",
         "end": "2011-05-17",
         "current": false,
         "coverage": {
           "fixtures": {
             "events": true,
             "lineups": true,
             "statistics_fixtures": false,
             "statistics_players": false
           },
           "standings": true,
           "players": true,
           "top_scorers": true,
           "predictions": true,
           "odds": false
         }
       },
       {
         "year": 2011,
         "start": "2011-08-13",
         "end": "2012-05-13",
         "current": false,
         "coverage": {
           "fixtures": {
             "events": true,
             "lineups": true,
             "statistics_fixtures": false,
             "statistics_players": false
           },
           "standings": true,
           "players": true,
           "top_scorers": true,
           "predictions": true,
           "odds": false
         }
       }
     ]
   }
 ]
}

/teams

GET

Summary:

Teams information

Description:

Get the list of available teams.
The team id are unique in the API and teams keep it among all the leagues/cups in which they participate.
> Examples available in Request samples "Use Cases".
> All the parameters of this endpoint can be used together.
> This endpoint requires at least one parameter.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
id query The id of the team No integer
name query The name of the team No string
league query The id of the league No integer
season query The season of the league No integer
country query The country name of the team No string
search query The name or the country name of the team No string
// Get one team from one team {id}
get("https://api-football-beta.p.rapidapi.com/teams?id=33");
// Get one team from one team {name}
get("https://api-football-beta.p.rapidapi.com/teams?name=manchester united");
// Get all teams from one {league} & {season}
get("https://api-football-beta.p.rapidapi.com/teams?league=39&season=2019");
// Get teams from one team {country}
get("https://api-football-beta.p.rapidapi.com/teams?country=england");
// Allows you to search for a team in relation to a team {name} or {country}
get("https://api-football-beta.p.rapidapi.com/teams?search=manches");
get("https://api-football-beta.p.rapidapi.com/teams?search=England");
Responses
Code Description
200 OK
{
 "get": "teams",
 "parameters": {
   "id": "33"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "team": {
       "id": 33,
       "name": "Manchester United",
       "country": "England",
       "founded": 1878,
       "national": false,
       "logo": "https://media.api-football.com/teams/33.png"
     },
     "coach": {
       "id": 19,
       "name": "O. Solskjær",
       "firstname": "Ole Gunnar",
       "lastname": "Solskjær"
     },
     "venue": {
       "name": "Old Trafford",
       "address": "Sir Matt Busby Way",
       "city": "Manchester",
       "capacity": 76212,
       "surface": "grass"
     }
   }
 ]
}

/teams/statistics

GET

Summary:

Teams statistics

Description:
Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
league query The id of the league Yes integer
season query The season of the league Yes integer
team query The id of the team Yes integer
date query The limit date No string
// Get all statistics for a {team} in a {league} & {season}
get("https://api-football-beta.p.rapidapi.com/teams/statistics?league=39&team=33&season=2019");
//Get all statistics for a {team} in a {league} & {season} with a end {date}
get("https://api-football-beta.p.rapidapi.com/teams/statistics?league=39&team=33&season=2019&date=2019-10-08");
Responses
Code Description
200 OK
{
 "get": "teams/statistics",
 "parameters": {
   "team": "33",
   "league": "39",
   "season": "2019"
 },
 "errors": [],
 "results": 4,
 "response": {
   "league": {
     "id": 39,
     "name": "Premier League",
     "country": "England",
     "logo": "https://media.api-football.com/leagues/2.png",
     "flag": "https://media.api-football.com/flags/gb.svg",
     "season": 2019
   },
   "team": {
     "id": 33,
     "name": "Manchester United",
     "logo": "https://media.api-football.com/teams/33.png"
   },
   "matches": {
     "played": {
       "home": 12,
       "away": 12,
       "total": 24
     },
     "wins": {
       "home": 6,
       "away": 3,
       "total": 9
     },
     "draws": {
       "home": 4,
       "away": 3,
       "total": 7
     },
     "loses": {
       "home": 2,
       "away": 6,
       "total": 8
     }
   },
   "goals": {
     "for": {
       "total": {
         "home": 24,
         "away": 12,
         "total": 36
       },
       "average": {
         "home": "2.0",
         "away": "1.0",
         "total": "1.5"
       }
     },
     "against": {
       "total": {
         "home": 12,
         "away": 17,
         "total": 29
       },
       "average": {
         "home": "1.0",
         "away": "1.4",
         "total": "1.2"
       }
     }
   }
 }
}

/standings

GET

Summary:

Standings

Description:

Get the standings for a league or a team.
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…
> Examples available in Request samples "Use Cases".
> Most of the parameters of this endpoint can be used together.
Standings are updated every hours

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
league query The id of the league No integer
season query The season of the league Yes integer
team query The id of the team No integer
// Get all Standings from one {league} & {season}
get("https://api-football-beta.p.rapidapi.com/standings?league=39&season=2019");
// Get all Standings from one {league} & {season} & {team}
get("https://api-football-beta.p.rapidapi.com/standings?league=39&team=33&season=2019");
// Get all Standings from one {team} & {season}
get("https://api-football-beta.p.rapidapi.com/standings?team=33&season=2019");
Responses
Code Description
200 OK
{
 "get": "standings",
 "parameters": {
   "league": "39",
   "season": "2019"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "league": {
       "id": 39,
       "name": "Premier League",
       "country": "England",
       "logo": "https://media.api-football.com/leagues/2.png",
       "flag": "https://media.api-football.com/flags/gb.svg",
       "season": 2019,
       "standings": [
         [
           {
             "rank": 1,
             "team": {
               "id": 40,
               "name": "Liverpool",
               "logo": "https://media.api-football.com/teams/40.png"
             },
             "points": 70,
             "goalsDiff": 41,
             "group": "Premier League",
             "form": "WWWWW",
             "status": "same",
             "description": "Promotion - Champions League (Group Stage)",
             "all": {
               "played": 24,
               "win": 23,
               "draw": 1,
               "lose": 0,
               "goals": {
                 "for": 56,
                 "against": 15
               }
             },
             "home": {
               "played": 12,
               "win": 12,
               "draw": 0,
               "lose": 0,
               "goals": {
                 "for": 31,
                 "against": 9
               }
             },
             "away": {
               "played": 12,
               "win": 11,
               "draw": 1,
               "lose": 0,
               "goals": {
                 "for": 25,
                 "against": 6
               }
             },
             "update": "2020-01-29T00:00:00+00:00"
           }
         ]
       ]
     }
   }
 ]
}

/fixtures/rounds

GET

Summary:

Rounds

Description:

Get the rounds for a league or a cup.
The round can be used in endpoint fixtures as filters
> Examples available in Request samples "Use Cases".

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
league query The id of the league Yes integer
season query The season of the league No integer
current query The current round only No boolean
// Get all available rounds from one {league} & {season}
get("https://api-football-beta.p.rapidapi.com/rounds?league=39&season=2019");
// Get current round from one {league} & {season}
get("https://api-football-beta.p.rapidapi.com/rounds?league=39&season=2019¤t=true");
Responses
Code Description
200 OK
{
 "get": "fixtures/rounds",
 "parameters": {
   "league": "39",
   "season": "2019"
 },
 "errors": [],
 "results": 38,
 "response": [
   "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 - 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",
   "Regular Season - 31",
   "Regular Season - 32",
   "Regular Season - 33",
   "Regular Season - 34",
   "Regular Season - 35",
   "Regular Season - 36",
   "Regular Season - 37",
   "Regular Season - 38"
 ]
}

/fixtures

GET

Summary:

Fixtures

Description:

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
> Some leagues have only final result check our coverage page to know which ones
Available fixtures 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
    > Fixtures are updated every 15 seconds
Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
id query The id of the fixture No integer
live query No string
date query A valid date No string
league query The id of the league No integer
season query The season of the league No integer
team query The id of the team No integer
last query No integer
next query No integer
from query A valid date No string
to query A valid date No string
round query The round of the fixture No string
status query The status short No string
timezone query No string
// Get fixture from one fixture {id}
// In this request events, lineups, statistics fixture and players fixture are returned in the response
get("https://api-football-beta.p.rapidapi.com/fixtures?id=215662");
// Get all available fixtures in play
// In this request events are returned in the response
get("https://api-football-beta.p.rapidapi.com/fixtures?live=all");
// Get all available fixtures in play filter by several {league}
// In this request events are returned in the response
get("https://api-football-beta.p.rapidapi.com/fixtures?live=39-61-48");
// Get all available fixtures from one {league} & {season}
get("https://api-football-beta.p.rapidapi.com/fixtures?league=39&season=2019");
// Get all available fixtures from one {date}
get("https://api-football-beta.p.rapidapi.com/fixtures?date=2019-10-22");
// Get next X available fixtures
get("https://api-football-beta.p.rapidapi.com/fixtures?next=15");
// Get last X available fixtures
get("https://api-football-beta.p.rapidapi.com/fixtures?last=15");
// It’s possible to make requests by mixing the available parameters
get("https://api-football-beta.p.rapidapi.com/fixtures?date=2020-01-30&league=61&season=2019");
get("https://api-football-beta.p.rapidapi.com/fixtures?league=61&season=2019&status=pst");
get("https://api-football-beta.p.rapidapi.com/fixtures?league=61&next=10");
get("https://api-football-beta.p.rapidapi.com/fixtures?league=61&next=10&status=ns");
get("https://api-football-beta.p.rapidapi.com/fixtures?team=85&last=10&timezone=Europe/london");
get("https://api-football-beta.p.rapidapi.com/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31");
get("https://api-football-beta.p.rapidapi.com/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london");
get("https://api-football-beta.p.rapidapi.com/fixtures?league=61&season=2019&round=Regular Season - 1");
Responses
Code Description
200 OK
{
 "get": "fixtures",
 "parameters": {
   "live": "all"
 },
 "errors": [],
 "results": 4,
 "response": [
   {
     "fixture": {
       "id": 239625,
       "venue": "Stade Municipal de Oued Zem, Oued Zem",
       "referee": null,
       "timezone": "UTC",
       "date": "2020-02-06T14:00:00+00:00",
       "timestamp": 1580997600,
       "periods": {
         "first": 1580997600,
         "second": null
       },
       "status": {
         "long": "Halftime",
         "short": "HT",
         "elapsed": 45
       }
     },
     "league": {
       "id": 200,
       "name": "Botola Pro",
       "country": "Morocco",
       "logo": "https://media.api-football.com/leagues/115.png",
       "flag": "https://media.api-football.com/flags/ma.svg",
       "season": 2019,
       "round": "Regular Season - 14"
     },
     "teams": {
       "home": {
         "id": 967,
         "name": "Rapide Oued ZEM",
         "logo": "https://media.api-football.com/teams/967.png"
       },
       "away": {
         "id": 968,
         "name": "Wydad AC",
         "logo": "https://media.api-football.com/teams/968.png"
       }
     },
     "goals": {
       "home": 0,
       "away": 1
     },
     "score": {
       "halftime": {
         "home": 0,
         "away": 1
       },
       "fulltime": {
         "home": null,
         "away": null
       },
       "extratime": {
         "home": null,
         "away": null
       },
       "penalty": {
         "home": null,
         "away": null
       }
     }
   }
 ]
}

/fixtures/headtohead

GET

Summary:

Head To Head

Description:

Get heads to heads between two teams.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
h2h query The ids of the teams Yes string
date query No string
league query The id of the league No integer
season query The season of the league No integer
status query The status short No string
last query No integer
next query No integer
from query No string
to query No string
timezone query No string
// Get all head to head between two {team}
get("https://api-football-beta.p.rapidapi.com/fixtures/headtohead?h2h=33-34");
// It’s possible to make requests by mixing the available parameters
get("https://api-football-beta.p.rapidapi.com/fixtures/headtohead?h2h=33-34");
get("https://api-football-beta.p.rapidapi.com/fixtures/headtohead?h2h=33-34&from=2019-10-01&to=2019-10-31");
get("https://api-football-beta.p.rapidapi.com/fixtures/headtohead?date=2019-10-22&h2h=33-34");
get("https://api-football-beta.p.rapidapi.com/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5");
get("https://api-football-beta.p.rapidapi.com/fixtures/headtohead?league=39&season=2019&h2h=33-34&next=10&from=2019-10-01&to=2019-10-31");
get("https://api-football-beta.p.rapidapi.com/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5&timezone=Europe/London");
Responses
Code Description
200 OK
{
 "get": "fixtures/head2head",
 "parameters": {
   "h2h": "33-34",
   "last": "1"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "fixture": {
       "id": 157201,
       "venue": "Old Trafford (Manchester)",
       "referee": "Kevin Friend, England",
       "timezone": "UTC",
       "date": "2019-12-26T17:30:00+00:00",
       "timestamp": 1577381400,
       "periods": {
         "first": 1577381400,
         "second": 1577385000
       },
       "status": {
         "long": "Match Finished",
         "short": "FT",
         "elapsed": 90
       }
     },
     "league": {
       "id": 39,
       "name": "Premier League",
       "country": "England",
       "logo": "https://media.api-football.com/leagues/2.png",
       "flag": "https://media.api-football.com/flags/gb.svg",
       "season": 2019,
       "round": "Regular Season - 19"
     },
     "teams": {
       "home": {
         "id": 33,
         "name": "Manchester United",
         "logo": "https://media.api-football.com/teams/33.png"
       },
       "away": {
         "id": 34,
         "name": "Newcastle",
         "logo": "https://media.api-football.com/teams/34.png"
       }
     },
     "goals": {
       "home": 4,
       "away": 1
     },
     "score": {
       "halftime": {
         "home": 3,
         "away": 1
       },
       "fulltime": {
         "home": 4,
         "away": 1
       },
       "extratime": {
         "home": null,
         "away": null
       },
       "penalty": {
         "home": null,
         "away": null
       }
     }
   }
 ]
}

/fixtures/statistics

GET

Summary:

Statistics

Description:

Get the statistics for one fixture.
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 %
    > Fixtures statistics are updated every 5 minutes
Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
fixture query The id of the fixture Yes integer
team query The id of the team No integer
type query The type of statistics No string
// Get all available statistics from one {fixture}
get("https://api-football-beta.p.rapidapi.com/fixtures/statistics?fixture=215662");
// Get all available statistics from one {fixture} & {type}
get("https://api-football-beta.p.rapidapi.com/fixtures/statistics?fixture=215662&type=Total Shots");
// Get all available statistics from one {fixture} & {team}
get("https://api-football-beta.p.rapidapi.com/fixtures/statistics?fixture=215662&team=463");
Responses
Code Description
200 OK
{
 "get": "fixtures/statistics",
 "parameters": {
   "team": "463",
   "fixture": "215662"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "team": {
       "id": 463,
       "name": "Aldosivi",
       "logo": "https://media.api-football.com/teams/463.png"
     },
     "statistics": [
       {
         "type": "Shots on Goal",
         "value": 3
       },
       {
         "type": "Shots off Goal",
         "value": 2
       },
       {
         "type": "Total Shots",
         "value": 9
       },
       {
         "type": "Blocked Shots",
         "value": 4
       },
       {
         "type": "Shots insidebox",
         "value": 4
       },
       {
         "type": "Shots outsidebox",
         "value": 5
       },
       {
         "type": "Fouls",
         "value": 22
       },
       {
         "type": "Corner Kicks",
         "value": 3
       },
       {
         "type": "Offsides",
         "value": 1
       },
       {
         "type": "Ball Possession",
         "value": "32%"
       },
       {
         "type": "Yellow Cards",
         "value": 5
       },
       {
         "type": "Red Cards",
         "value": 1
       },
       {
         "type": "Goalkeeper Saves",
         "value": null
       },
       {
         "type": "Total passes",
         "value": 242
       },
       {
         "type": "Passes accurate",
         "value": 121
       },
       {
         "type": "Passes %",
         "value": null
       }
     ]
   }
 ]
}

/fixtures/events

GET

Summary:

Events

Description:

Get the events from a fixture.
Available events

  • yellow card
  • red card
  • goal
  • own goal
  • penalty
  • missed penalty
  • substitution
    > Fixture events are updated every 15 seconds
Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
fixture query The id of the fixture Yes integer
team query The id of the team No integer
player query The id of the player No integer
type query The type No string
// Get all available events from one {fixture}
get("https://api-football-beta.p.rapidapi.com/fixtures/events?fixture=215662");
// Get all available events from one {fixture} & {team}
get("https://api-football-beta.p.rapidapi.com/fixtures/events?fixture=215662&team=463");
// Get all available events from one {fixture} & {player}
get("https://api-football-beta.p.rapidapi.com/fixtures/events?fixture=215662&player=35845");
// Get all available events from one {fixture} & {type}
get("https://api-football-beta.p.rapidapi.com/fixtures/events?fixture=215662&type=card");
// It’s possible to make requests by mixing the available parameters
get("https://api-football-beta.p.rapidapi.com/fixtures/events?fixture=215662&player=35845&type=card");
get("https://api-football-beta.p.rapidapi.com/fixtures/events?fixture=215662&team=463&type=goal&player=35845");
Responses
Code Description
200 OK
{
 "get": "fixtures/events",
 "parameters": {
   "fixture": "215662"
 },
 "errors": [],
 "results": 18,
 "response": [
   {
     "time": {
       "elapsed": 25,
       "extra": null
     },
     "team": {
       "id": 463,
       "name": "Aldosivi",
       "logo": "https://media.api-football.com/teams/463.png"
     },
     "player": {
       "id": 6126,
       "name": "F. Andrada"
     },
     "assist": {
       "id": null,
       "name": null
     },
     "type": "Goal",
     "detail": "Normal Goal",
     "comments": null
   },
   {
     "time": {
       "elapsed": 33,
       "extra": null
     },
     "team": {
       "id": 442,
       "name": "Defensa Y Justicia",
       "logo": "https://media.api-football.com/teams/442.png"
     },
     "player": {
       "id": 5936,
       "name": "Julio González"
     },
     "assist": {
       "id": null,
       "name": null
     },
     "type": "Card",
     "detail": "Yellow Card",
     "comments": null
   },
   {
     "time": {
       "elapsed": 33,
       "extra": null
     },
     "team": {
       "id": 463,
       "name": "Aldosivi",
       "logo": "https://media.api-football.com/teams/463.png"
     },
     "player": {
       "id": 6126,
       "name": "Federico Andrada"
     },
     "assist": {
       "id": null,
       "name": null
     },
     "type": "Card",
     "detail": "Yellow Card",
     "comments": null
   }
 ]
}

/fixtures/lineups

GET

Summary:

Lineups

Description:

get the lineups for a fixture.
Available datas

  • Formation
  • Coach
  • Start XI
  • Substitutes
    > Lineups are available between 20 and 40 minutes before the fixture.
Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
fixture query The id of the fixture Yes integer
team query The id of the team No integer
player query The id of the player No integer
type query The type No string
// Get all available lineups from one {fixture}
get("https://api-football-beta.p.rapidapi.com/fixtures/lineups?fixture=215662");
// Get all available lineups from one {fixture} & {team}
get("https://api-football-beta.p.rapidapi.com/fixtures/lineups?fixture=215662&team=463");
// Get all available lineups from one {fixture} & {player}
get("https://api-football-beta.p.rapidapi.com/fixtures/lineups?fixture=215662&player=35845");
// Get all available lineups from one {fixture} & {type}
get("https://api-football-beta.p.rapidapi.com/fixtures/lineups?fixture=215662&type=startXI");
// It’s possible to make requests by mixing the available parameters
get("https://api-football-beta.p.rapidapi.com/fixtures/lineups?fixture=215662&player=35845&type=startXI");
get("https://api-football-beta.p.rapidapi.com/fixtures/lineups?fixture=215662&team=463&type=startXI&player=35845");
Responses
Code Description
200 OK
{
 "get": "fixtures/lineups",
 "parameters": {
   "fixture": "215662",
   "team": "463"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "team": {
       "id": 463,
       "name": "Aldosivi",
       "logo": "https://media.api-football.com/teams/463.png"
     },
     "coach": {
       "id": 1696,
       "name": "F. Radaelli"
     },
     "formation": "4-3-3",
     "startXI": [
       {
         "player": {
           "id": 6258,
           "name": "L. Pocrnjic",
           "number": 1,
           "pos": "G"
         }
       },
       {
         "player": {
           "id": 6261,
           "name": "L. Galeano",
           "number": 6,
           "pos": "D"
         }
       },
       {
         "player": {
           "id": 52701,
           "name": "M. Miers",
           "number": 19,
           "pos": "D"
         }
       },
       {
         "player": {
           "id": 6268,
           "name": "L. Villalba",
           "number": 23,
           "pos": "D"
         }
       }
     ],
     "substitutes": [
       {
         "player": {
           "id": 35845,
           "name": "H. Burbano",
           "number": 11,
           "pos": "M"
         }
       },
       {
         "player": {
           "id": 6396,
           "name": "N. Bazzana",
           "number": 27,
           "pos": "D"
         }
       }
     ]
   }
 ]
}

/fixtures/players

GET

Summary:

Players statistics

Description:

Get the players statistics from one fixture.
This is a new endpoint, data start from 2018/2019 season we will add the history gradually
> Players statistics fixtures are updated every 5 minutes

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
fixture query The id of the fixture Yes integer
team query The id of the team No integer
// Get all available players statistics from one {fixture}
get("https://api-football-beta.p.rapidapi.com/fixtures/players?fixture=169080");
// Get all available players statistics from one {fixture} & {team}
get("https://api-football-beta.p.rapidapi.com/fixtures/players?fixture=169080&team=2284");
Responses
Code Description
200 OK
{
 "get": "fixtures/players",
 "parameters": {
   "fixture": "169080"
 },
 "errors": [],
 "results": 2,
 "response": [
   {
     "team": {
       "id": 2284,
       "name": "Monarcas",
       "logo": "https://media.api-football.com/teams/2284.png",
       "update": "2020-01-13T16:12:12+00:00"
     },
     "players": [
       {
         "player": {
           "id": 35931,
           "name": "Sebastián Sosa"
         },
         "statistics": [
           {
             "games": {
               "minutes": 90,
               "number": 13,
               "position": "G",
               "rating": "6.3",
               "captain": false,
               "substitute": false
             },
             "offsides": null,
             "shots": {
               "total": 0,
               "on": 0
             },
             "goals": {
               "total": null,
               "conceded": 1,
               "assists": null
             },
             "passes": {
               "total": 17,
               "key": 0,
               "accuracy": "68%"
             },
             "tackles": {
               "total": null,
               "blocks": 0,
               "interceptions": 0
             },
             "duels": {
               "total": null,
               "won": null
             },
             "dribbles": {
               "attempts": 0,
               "success": 0,
               "past": null
             },
             "fouls": {
               "drawn": 0,
               "committed": 0
             },
             "cards": {
               "yellow": 0,
               "red": 0
             },
             "penalty": {
               "won": null,
               "commited": null,
               "scored": 0,
               "missed": 0,
               "saved": 0
             }
           }
         ]
       }
     ]
   }
 ]
}

/predictions

GET

Summary:

Predictions

Description:

Get predictions about a fixture.
The predictions are made using several algorithms including the poisson distribution, 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
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
fixture query The id of the fixture Yes integer
// Get all available predictions from one {fixture}
get("https://api-football-beta.p.rapidapi.com/predictions?fixture=198772");
Responses
Code Description
200 OK
{
 "get": "predictions",
 "parameters": {
   "fixture": "198772"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "predictions": {
       "match_winner": "1 N",
       "under_over": "-3.5",
       "goals": {
         "home": "-2.5",
         "away": "-1.5"
       },
       "advice": "Combo Double chance : Deportivo Santani or draws  and -3.5 goals",
       "percent": {
         "home": "45%",
         "draws": "45%",
         "away": "10%"
       }
     },
     "league": {
       "id": 252,
       "name": "Primera Division - Clausura",
       "country": "Paraguay",
       "logo": null,
       "flag": "https://media.api-football.com/flags/py.svg",
       "season": 2019
     },
     "teams": {
       "home": {
         "id": 1189,
         "name": "Deportivo Santani",
         "logo": "https://media.api-football.com/teams/1189.png",
         "last_5": {
           "form": "60%",
           "att": "60%",
           "def": "0%",
           "goals": {
             "for": {
               "total": 3,
               "average": 0.6
             },
             "against": {
               "total": 5,
               "average": 1
             }
           }
         },
         "league": {
           "matches": {
             "played": {
               "home": 6,
               "away": 7,
               "total": 13
             },
             "wins": {
               "home": 2,
               "away": 2,
               "total": 4
             },
             "draws": {
               "home": 3,
               "away": 0,
               "total": 3
             },
             "loses": {
               "home": 1,
               "away": 5,
               "total": 6
             }
           },
           "goals": {
             "for": {
               "total": {
                 "home": 7,
                 "away": 4,
                 "total": 11
               },
               "average": {
                 "home": "1.2",
                 "away": "0.6",
                 "total": "0.8"
               }
             },
             "against": {
               "total": {
                 "home": 6,
                 "away": 14,
                 "total": 20
               },
               "average": {
                 "home": "1.0",
                 "away": "2.0",
                 "total": "1.5"
               }
             }
           }
         }
       },
       "away": {
         "id": 1180,
         "name": "Deportivo Capiata",
         "logo": "https://media.api-football.com/teams/1180.png",
         "last_5": {
           "form": "40%",
           "att": "80%",
           "def": "0%",
           "goals": {
             "for": {
               "total": 4,
               "average": 0.8
             },
             "against": {
               "total": 8,
               "average": 1.6
             }
           }
         },
         "league": {
           "matches": {
             "played": {
               "home": 7,
               "away": 6,
               "total": 13
             },
             "wins": {
               "home": 3,
               "away": 1,
               "total": 4
             },
             "draws": {
               "home": 0,
               "away": 2,
               "total": 2
             },
             "loses": {
               "home": 4,
               "away": 3,
               "total": 7
             }
           },
           "goals": {
             "for": {
               "total": {
                 "home": 8,
                 "away": 3,
                 "total": 11
               },
               "average": {
                 "home": "1.1",
                 "away": "0.5",
                 "total": "0.8"
               }
             },
             "against": {
               "total": {
                 "home": 14,
                 "away": 10,
                 "total": 24
               },
               "average": {
                 "home": "2.0",
                 "away": "1.7",
                 "total": "1.8"
               }
             }
           }
         }
       }
     },
     "comparison": {
       "form": {
         "home": "60%",
         "away": "40%"
       },
       "att": {
         "home": "43%",
         "away": "57%"
       },
       "def": {
         "home": "62%",
         "away": "38%"
       },
       "poisson_distribution": {
         "home": "75%",
         "away": "25%"
       },
       "h2h": {
         "home": "29%",
         "away": "71%"
       },
       "goals": {
         "home": "40%",
         "away": "60%"
       }
     },
     "h2h": [
       {
         "fixture": {
           "id": 198706,
           "venue": "Estadio Lic. Erico Galeano Segovia (Capiatá)",
           "referee": null,
           "timezone": "UTC",
           "date": "2019-07-27T19:30:00+00:00",
           "timestamp": 1564255800,
           "periods": {
             "first": 1564255800,
             "second": 1564259400
           },
           "status": {
             "long": "Match Finished",
             "short": "FT",
             "elapsed": 90
           }
         },
         "league": {
           "id": 252,
           "name": "Primera Division - Clausura",
           "country": "Paraguay",
           "logo": null,
           "flag": "https://media.api-football.com/flags/py.svg",
           "season": 2019,
           "round": "Regular Season - 3"
         },
         "teams": {
           "home": {
             "id": 1180,
             "name": "Deportivo Capiata",
             "logo": "https://media.api-football.com/teams/1180.png"
           },
           "away": {
             "id": 1189,
             "name": "Deportivo Santani",
             "logo": "https://media.api-football.com/teams/1189.png"
           }
         },
         "goals": {
           "home": 3,
           "away": 1
         },
         "score": {
           "halftime": {
             "home": 1,
             "away": 1
           },
           "fulltime": {
             "home": 3,
             "away": 1
           },
           "extratime": {
             "home": null,
             "away": null
           },
           "penalty": {
             "home": null,
             "away": null
           }
         }
       }
     ]
   }
 ]
}

/coachs

GET

Summary:

Coachs

Description:

Get all the information about the coachs and their careers.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
id query The id of the coach No integer
team query The id of the team No integer
search query The name of the coach No string
// Get coachs from one coach {id}
get("https://api-football-beta.p.rapidapi.com/coachs?id=1");
// Get coachs from one {team}
get("https://api-football-beta.p.rapidapi.com/coachs?team=33");
// Allows you to search for a coach in relation to a coach {name}
get("https://api-football-beta.p.rapidapi.com/coachs?search=Klopp");
Responses
Code Description
200 OK
{
 "get": "coachs",
 "parameters": {
   "team": "85"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "id": 40,
     "name": "T. Tuchel",
     "firstname": "Thomas",
     "lastname": "Tuchel",
     "age": 46,
     "birth": {
       "date": "29/08/1973",
       "place": "Krumbach",
       "country": "Germany"
     },
     "nationality": "Germany",
     "height": "192 cm",
     "weight": "85 kg",
     "team": {
       "id": 85,
       "name": "PSG",
       "logo": "https://media.api-football.com/teams/85.png"
     },
     "career": [
       {
         "team": {
           "id": 85,
           "name": "PSG",
           "logo": "https://media.api-football.com/teams/85.png"
         },
         "start": "01/07/2018",
         "end": null
       },
       {
         "team": {
           "id": 165,
           "name": "Borussia Dortmund",
           "logo": "https://media.api-football.com/teams/165.png"
         },
         "start": "01/07/2015",
         "end": "30/05/2017"
       },
       {
         "team": {
           "id": 164,
           "name": "Mainz 05",
           "logo": "https://media.api-football.com/teams/164.png"
         },
         "start": "03/08/2009",
         "end": "12/05/2014"
       }
     ]
   }
 ]
}

/players/seasons

GET

Summary:

Seasons

Description:

Get all available seasons for players statistics.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
get('https://api-football-beta.p.rapidapi.com/players/seasons');
Responses
Code Description
200 OK
{
 "get": "players/seasons",
 "parameters": [],
 "errors": [],
 "results": 35,
 "response": [
   1966,
   1982,
   1986,
   1990,
   1991,
   1992,
   1993,
   1994,
   1995,
   1996,
   1997,
   1998,
   1999,
   2000,
   2001,
   2002,
   2003,
   2004,
   2005,
   2006,
   2007,
   2008,
   2009,
   2010,
   2011,
   2012,
   2013,
   2014,
   2015,
   2016,
   2017,
   2018,
   2019,
   2020,
   2022
 ]
}

/players

GET

Summary:

Players

Description:

Get players statistics.
The players id are unique in the API and players keep it among all the teams they have been in
The statistics are calculated according to the team id, league id and season.
You can find the available seasons by using the endpoint players seasons
> Players statistics are updated several times a week

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
id query The id of the player No integer
team query The id of the team No integer
league query The id of the league No integer
season query The season of the league No integer
search query The name of the player No string
// Get all players statistics from one player {id}
get("https://api-football-beta.p.rapidapi.com/players?id=19088");
get("https://api-football-beta.p.rapidapi.com/players?id=19088&season=2018");
// Get all players statistics from one {team} & {season}
get("https://api-football-beta.p.rapidapi.com/players?season=2018&team=33");
// Allows you to search for a player in relation to a player {name}
get("https://api-football-beta.p.rapidapi.com/players?team=85&search=cavani");
get("https://api-football-beta.p.rapidapi.com/players?league=61&search=cavani");
get("https://api-football-beta.p.rapidapi.com/players?team=85&search=cavani&season=2018");
Responses
Code Description
200 OK
{
 "get": "players",
 "parameters": {
   "id": "276"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "player": {
       "id": 276,
       "name": "Neymar",
       "firstname": "Neymar",
       "lastname": "da Silva Santos Junior",
       "age": 28,
       "birth": {
         "date": "05/02/1992",
         "place": "Mogi das Cruzes",
         "country": "Brazil"
       },
       "nationality": "Brazil",
       "height": "175 cm",
       "weight": "68 kg",
       "injured": false
     },
     "statistics": [
       {
         "team": {
           "id": 85,
           "name": "Paris Saint Germain",
           "logo": "https://media.api-football.com/teams/85.png"
         },
         "league": {
           "id": 61,
           "name": "Ligue 1",
           "country": "France",
           "logo": "https://media.api-football.com/leagues/4.svg",
           "flag": "https://media.api-football.com/flags/fr.svg",
           "season": 2019
         },
         "games": {
           "appearances": 14,
           "lineups": 14,
           "minutes": 1232,
           "number": null,
           "position": "Attacker",
           "rating": "8.107142",
           "captain": false
         },
         "substitutes": {
           "in": 0,
           "out": 3,
           "bench": 0
         },
         "shots": {
           "total": 65,
           "on": 36
         },
         "goals": {
           "total": 13,
           "conceded": null,
           "assists": 6
         },
         "passes": {
           "total": 650,
           "key": 35,
           "accuracy": 78
         },
         "tackles": {
           "total": 11,
           "blocks": 0,
           "interceptions": 3
         },
         "duels": {
           "total": null,
           "won": null
         },
         "dribbles": {
           "attempts": 125,
           "success": 79,
           "past": null
         },
         "fouls": {
           "drawn": 59,
           "committed": 12
         },
         "cards": {
           "yellow": 2,
           "yellowred": 0,
           "red": 0
         },
         "penalty": {
           "won": 1,
           "commited": null,
           "scored": 4,
           "missed": 1,
           "saved": null
         }
       }
     ]
   }
 ]
}

/players/topscorers

GET

Summary:

Top Scorers

Description:

get the 20 best players for a league or cup.
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
    > Topscorers are updated several times a week
Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
league query The id of the league Yes integer
season query The season of the league Yes integer
get('https://api-football-beta.p.rapidapi.com/players/topscorers?season=2019&league=61');
Responses
Code Description
200 OK
{
 "get": "players/topscorers",
 "parameters": {
   "season": "2018",
   "league": "61"
 },
 "errors": [],
 "results": 20,
 "response": [
   {
     "player": {
       "id": 278,
       "name": "Kylian Mbappé Lottin",
       "firstname": "Kylian",
       "lastname": "Mbappé Lottin",
       "age": 22,
       "birth": {
         "date": "20/12/1998",
         "place": "Paris",
         "country": "France"
       },
       "nationality": "France",
       "height": "178 cm",
       "weight": "73 kg",
       "injured": false
     },
     "statistics": [
       {
         "team": {
           "id": 85,
           "name": "Paris Saint Germain",
           "logo": "https://media.api-football.com/teams/85.png"
         },
         "league": {
           "id": 61,
           "name": "Ligue 1",
           "country": "France",
           "logo": "https://media.api-football.com/leagues/4.svg",
           "flag": "https://media.api-football.com/flags/fr.svg",
           "season": 2018
         },
         "games": {
           "appearances": 29,
           "lineups": 24,
           "minutes": 2340,
           "number": null,
           "position": "Attacker",
           "rating": "7.871428",
           "captain": false
         },
         "substitutes": {
           "in": 5,
           "out": 1,
           "bench": 5
         },
         "shots": {
           "total": 122,
           "on": 68
         },
         "goals": {
           "total": 33,
           "conceded": null,
           "assists": 7
         },
         "passes": {
           "total": 591,
           "key": 48,
           "accuracy": 78
         },
         "tackles": {
           "total": 4,
           "blocks": 0,
           "interceptions": 4
         },
         "duels": {
           "total": 232,
           "won": 112
         },
         "dribbles": {
           "attempts": 115,
           "success": 64,
           "past": null
         },
         "fouls": {
           "drawn": 39,
           "committed": 19
         },
         "cards": {
           "yellow": 5,
           "yellowred": 0,
           "red": 1
         },
         "penalty": {
           "won": 3,
           "commited": null,
           "scored": 1,
           "missed": 0,
           "saved": null
         }
       }
     ]
   }
 ]
}

/transfers

GET

Summary:

Transfers

Description:

Get all available transfers for players and teams
> Transfers are updated several times a week

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
player query The id of the player No integer
team query The id of the team No integer
// Get all transfers from one {player}
get("https://api-football-beta.p.rapidapi.com/transfers?player=35845");
// Get all transfers from one {team}
get("https://api-football-beta.p.rapidapi.com/transfers?team=463");
Responses
Code Description
200 OK
{
 "get": "transfers",
 "parameters": {
   "player": "35845"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "player": {
       "id": 35845,
       "name": "Hernán Darío Burbano"
     },
     "update": "2020-02-06T00:08:15+00:00",
     "transfers": [
       {
         "date": "2019-07-15",
         "type": "Free",
         "teams": {
           "in": {
             "id": 2283,
             "name": "Atlas",
             "logo": "https://media.api-football.com/teams/2283.png"
           },
           "out": {
             "id": 2283,
             "name": "Atlas",
             "logo": "https://media.api-football.com/teams/2283.png"
           }
         }
       },
       {
         "date": "2019-01-01",
         "type": "N/A",
         "teams": {
           "in": {
             "id": 1937,
             "name": "Atletico Atlas",
             "logo": "https://media.api-football.com/teams/1937.png"
           },
           "out": {
             "id": 1139,
             "name": "Santa Fe",
             "logo": "https://media.api-football.com/teams/1139.png"
           }
         }
       },
       {
         "date": "2018-07-01",
         "type": "N/A",
         "teams": {
           "in": {
             "id": 1139,
             "name": "Santa Fe",
             "logo": "https://media.api-football.com/teams/1139.png"
           },
           "out": {
             "id": 2289,
             "name": "Leon",
             "logo": "https://media.api-football.com/teams/2289.png"
           }
         }
       },
       {
         "date": "2015-06-11",
         "type": "N/A",
         "teams": {
           "in": {
             "id": 2289,
             "name": "Leon",
             "logo": "https://media.api-football.com/teams/2289.png"
           },
           "out": {
             "id": 2279,
             "name": "Tigres UANL",
             "logo": "https://media.api-football.com/teams/2279.png"
           }
         }
       }
     ]
   }
 ]
}

/trophies

GET

Summary:

Trophies

Description:

Get all available trophies for a player or a coach.
> Trophies are updated several times a week

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
player query The id of the player No integer
coach query The id of the coach No integer
// Get all trophies from one {player}
get("https://api-football-beta.p.rapidapi.com/trophies?player=276");
// Get all trophies from one {coach}
get("https://api-football-beta.p.rapidapi.com/trophies?coach=2");
Responses
Code Description
200 OK
{
 "get": "trophies",
 "parameters": {
   "player": "276"
 },
 "errors": [],
 "results": 38,
 "response": [
   {
     "league": "Sudamericano U20",
     "country": "South-America",
     "season": "Peru 2011",
     "place": "Winner"
   },
   {
     "league": "Trophée des Champions",
     "country": "France",
     "season": "2019/2020",
     "place": "Winner"
   },
   {
     "league": "Copa America",
     "country": "South-America",
     "season": "2019 Brazil",
     "place": "Winner"
   },
   {
     "league": "Ligue 1",
     "country": "France",
     "season": "2018/2019",
     "place": "Winner"
   },
   {
     "league": "Coupe de France",
     "country": "France",
     "season": "2018/2019",
     "place": "2nd Place"
   },
   {
     "league": "Trophée des Champions",
     "country": "France",
     "season": "2018/2019",
     "place": "Winner"
   },
   {
     "league": "Ligue 1",
     "country": "France",
     "season": "2017/2018",
     "place": "Winner"
   }
 ]
}

/sidelined

GET

Summary:

Sidelined

Description:

Get all available sidelined for a player or a coach.
> Sidelined are updated several times a week

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
player query The id of the player No integer
coach query The id of the coach No integer
// Get all from one {player}
get("https://api-football-beta.p.rapidapi.com/sidelined?player=276");
// Get all from one {coach}
get("https://api-football-beta.p.rapidapi.com/sidelined?coach=2");
Responses
Code Description
200 OK
{
 "get": "sidelined",
 "parameters": {
   "player": "276"
 },
 "errors": [],
 "results": 25,
 "response": [
   {
     "type": "Groin/Pelvis Injury",
     "start": "11/10/19",
     "end": "20/11/19"
   },
   {
     "type": "Ankle/Foot Injury",
     "start": "01/08/19",
     "end": "23/08/19"
   },
   {
     "type": "Suspended",
     "start": "15/05/19",
     "end": "27/05/19"
   },
   {
     "type": "Ankle/Foot Injury",
     "start": "24/01/19",
     "end": "20/04/19"
   },
   {
     "type": "Groin Strain",
     "start": "03/12/18",
     "end": "02/01/19"
   },
   {
     "type": "Groin Strain",
     "start": "21/11/18",
     "end": "27/11/18"
   },
   {
     "type": "Broken Toe",
     "start": "26/02/18",
     "end": "20/05/18"
   },
   {
     "type": "Thigh Muscle Strain",
     "start": "20/01/18",
     "end": "25/01/18"
   },
   {
     "type": "Rib Injury",
     "start": "11/01/18",
     "end": "16/01/18"
   },
   {
     "type": "Suspended",
     "start": "05/12/17",
     "end": "11/12/17"
   },
   {
     "type": "Thigh Muscle Strain",
     "start": "03/11/17",
     "end": "15/11/17"
   }
 ]
}

/odds

GET

Summary:

Odds

Description:

Get odds from fixtures or leagues.
We provide pre-match odds between 1 and 7 days before the fixture.
We keep a 7-day history (The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers)
> Odds are updated once a day

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
fixture query The id of the fixture No integer
league query The id of the league No integer
season query The season of the league No integer
bookmaker query The id of the bookmaker No integer
bet query The id of the bet No integer
// Get all available odds from one {fixture}
get("https://api-football-beta.p.rapidapi.com/odds?fixture=164327");
// Get all available odds from one {league} & {season}
get("https://api-football-beta.p.rapidapi.com/odds?league=39&season=2019");
// It’s possible to make requests by mixing the available parameters
get("https://api-football-beta.p.rapidapi.com/odds?bookmaker=1&bet=4&league=39&season=2019");
get("https://api-football-beta.p.rapidapi.com/odds?bet=4&fixture=164327");
get("https://api-football-beta.p.rapidapi.com/odds?bookmaker=1&league=39&season=2019");
Responses
Code Description
200 OK
{
 "get": "odds",
 "parameters": {
   "bookmaker": "6",
   "bet": "1",
   "fixture": "157140",
   "league": "39",
   "season": "2019"
 },
 "errors": [],
 "results": 1,
 "response": [
   {
     "league": {
       "id": 39,
       "name": "Premier League",
       "country": "England",
       "logo": "https://media.api-football.com/leagues/2.png",
       "flag": "https://media.api-football.com/flags/gb.svg",
       "season": 2019
     },
     "fixture": {
       "id": 157140
     },
     "update": "2019-11-19T02:30:47+00:00",
     "bookmakers": [
       {
         "id": 6,
         "name": "Bwin",
         "bets": [
           {
             "id": 1,
             "name": "Match Winner",
             "values": [
               {
                 "value": "Home",
                 "odd": "1.40"
               },
               {
                 "value": "Draw",
                 "odd": "5.00"
               },
               {
                 "value": "Away",
                 "odd": "7.25"
               }
             ]
           }
         ]
       }
     ]
   }
 ]
}

/odds/bookmakers

GET

Summary:

Bookmakers

Description:

Get all available bookmakers.
All bookmakers id can be used in endpoint odds as filters.

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
id query The id of the bookmaker No integer
search query the name of the bookmaker No string
// Get all available bookmakers
get("https://api-football-beta.p.rapidapi.com/odds/bookmakers");
// Get bookmaker from one {id}
get("https://api-football-beta.p.rapidapi.com/odds/bookmakers?id=1");
// Allows you to search for a bookmaker in relation to a bookmakers {name}
get("https://api-football-beta.p.rapidapi.com/odds/bookmakers?search=Betfair");
Responses
Code Description
200 OK
{
 "get": "odds/bookmakers",
 "parameters": [],
 "errors": [],
 "results": 15,
 "response": [
   {
     "id": 1,
     "name": "10Bet"
   },
   {
     "id": 2,
     "name": "Marathonbet"
   },
   {
     "id": 3,
     "name": "Betfair"
   },
   {
     "id": 4,
     "name": "Pinnacle"
   },
   {
     "id": 5,
     "name": "Sport Betting Online"
   },
   {
     "id": 6,
     "name": "Bwin"
   },
   {
     "id": 7,
     "name": "William Hill"
   },
   {
     "id": 8,
     "name": "Bet365"
   },
   {
     "id": 9,
     "name": "Dafabet"
   },
   {
     "id": 10,
     "name": "Ladbrokes"
   },
   {
     "id": 11,
     "name": "1xBet"
   },
   {
     "id": 12,
     "name": "BetFred"
   },
   {
     "id": 13,
     "name": "188Bet"
   },
   {
     "id": 15,
     "name": "Interwetten"
   },
   {
     "id": 16,
     "name": "Unibet"
   }
 ]
}

/odds/bets

GET

Summary:

Bets

Description:

Get all available bets.
All bets id can be used in endpoint odds as filters

Parameters
Name Located in Description Required Schema
x-rapidapi-key header Your RapidAPI Key Yes string
id query The id of the bet name No string
search query The name of the bet No string
// Get all available bets
get("https://api-football-beta.p.rapidapi.com/odds/bets");
// Get bet from one {id}
get("https://api-football-beta.p.rapidapi.com/odds/bets?id=1");
// Allows you to search for a bet in relation to a bets {name}
get("https://api-football-beta.p.rapidapi.com/odds/bets?search=winner");
Responses
Code Description
200 OK
{
 "get": "api/alpha/odds/bets",
 "parameters": {
   "search": "under"
 },
 "errors": [],
 "results": 7,
 "response": [
   {
     "id": 5,
     "name": "Goals Over/Under"
   },
   {
     "id": 6,
     "name": "Goals Over/Under First Half"
   },
   {
     "id": 26,
     "name": "Goals Over/Under - Second Half"
   },
   {
     "id": 45,
     "name": "Corners Over Under"
   },
   {
     "id": 57,
     "name": "Home Corners Over/Under"
   },
   {
     "id": 58,
     "name": "Away Corners Over/Under"
   },
   {
     "id": 74,
     "name": "10 Over/Under"
   }
 ]
}
Have a question about this API?Ask the API Provider.
More by api-sports
8.9
26ms
100%
9.7
36ms
100%
9.9
66ms
100%
7.2
27ms
100%
9.9
113ms
100%
Developers who viewed Api-Football-Beta also viewed
9.7
36ms
100%
9.5
220ms
100%
9.9
113ms
100%
9.9
66ms
100%

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication