RapidAPI logo

Sign Up

Log In

API-FOOTBALL

FREEMIUM
By api-sports
Updated a day ago
Sports
9.9/10
Popularity Score
659ms
Latency
100%
Success Rate

API-FOOTBALL API Documentation

We cover 186 football major and minor leagues and many more to come. Livescore, pre-matchs odds, events, line-ups, players, standings, statistics. Check our demo => https://www.api-football.com/demo/

View API Details
fixtures
GET/fixtures/date/{date}
GET/fixtures/live
GET/fixtures/league/{league_id}
GET/fixtures/team/{team_id}
GET/fixtures/id/{fixture_id}
GET/fixtures/h2h/{team_1}/{team_2}
GET/v2/fixtures/league/{league_id}
GET/v2/fixtures/date/{date}
GET/v2/fixtures/h2h/{team_1}/{team_2}
GET/v2/fixtures/live
GET/v2/fixtures/id/{fixture_id}
GET/v2/fixtures/team/{team_id}
teams
GET/teams/team/{team_id}
GET/teams/league/{league_id}
GET/v2/teams/team/{team_id}
GET/v2/teams/league/{league_id}
countries & seasons
GET/countries
GET/seasons
GET/v2/seasons
GET/v2/countries
leagues
GET/leagues
GET/leagues/league/{league_id}
GET/leagues/season/{season}
GET/leagues/country/{country_name}/{season}
GET/v2/leagues/country/{country_name}/{season}
GET/v2/leagues
GET/v2/leagues/league/{league_id}
GET/v2/leagues/season/{season}
odds
GET/odds/{fixture_id}
GET/v2/odds/bookmakers/
GET/v2/odds/league/{league_id}
GET/v2/odds/labels/
GET/v2/odds/fixture/{fixture_id}
events
GET/events/{fixture_id}
GET/v2/events/{fixture_id}
standings
GET/standings/{league_id}
GET/leagueTable/{league_id}
GET/v2/leagueTable/{league_id}
statistics
GET/statistics/{league_id}/{team_id}
GET/statistics/{league_id}/{team_id}/{date}
GET/statistics/fixture/{fixture_id}
GET/v2/statistics/{league_id}/{team_id}
GET/v2/statistics/fixture/{fixture_id}
GET/v2/statistics/{league_id}/{team_id}/{date}
lineups & players
GET/lineups/{fixture_id}
GET/players/{season}/{team_id}
GET/v2/lineups/{fixture_id}
GET/v2/players/team/{team_id}
GET/v2/players/player/{player_id}
GET/lineups/{fixture_id}

Get line ups from one fixture

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
fixture_idNUMBER
REQUIRED
Request Snippet
unirest.get("https://api-football-v1.p.rapidapi.com/lineups/{fixture_id}")
.header("X-RapidAPI-Host", "api-football-v1.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
Sample Response
Log inSign up

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.get("https://api-football-v1.p.rapidapi.com/lineups/{fixture_id}")
.header("X-RapidAPI-Host", "api-football-v1.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication