RapidAPI logo

Sign Up

Log In

API-FOOTBALL

FREEMIUM
By api-sports
Updated 3 days ago
Sports
9.9/10
Popularity Score
652ms
Latency
100%
Success Rate

API-FOOTBALL API Overview

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/

Contact API Provider
star-blueRate

NEW RELEASE AVAILABLE

Our new version (v2) is available. Consult our documentation to find out what's new. (The current version will always be available)

API - COVERAGE

To know all the leagues available, click on the link : OUR COVERAGE or scroll down

Livescore, Events, LineUps, statistics

Matches and Events are updated every minute, some leagues have only final result only (check in our coverage table).
Lineups are available between 20 and 40 minutes before the match.
Matchs Statistics are updated every 20 minutes.
Standings are updated every each end match.

Matchs 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

Events :

  • yellow cards
  • second yellow cards
  • red cards
  • goals
  • own goals
  • penalty
  • missed penalty
  • substitution

Line ups :

  • Formation (4-3-3)
  • Coach
  • Start 11
  • Substitutes

Statistics :

  • Assists
  • Blocked Shots
  • Corner Kicks
  • Counter Attacks
  • Cross Attacks
  • Fouls
  • Free Kicks
  • Goals
  • Goal Attempts
  • Offsides
  • Ball Possession
  • Red Cards
  • Goalkeeper Saves
  • Shots off Goal
  • Shots on Goal
  • Substitutions
  • Throwins
  • Medical Treatment
  • Yellow Cards

Players

We provide a set of statistics on the current season of players.
Players statistics and infos are updated every days.

  • position
  • number
  • injured
  • rating
  • shots
  • goals
  • passes
  • tackles
  • duels
  • dribbles
  • fouls
  • cards
  • penalty
  • games
  • substitutes

Pre-match Odds

We provide pre-match odds between 1 and 7 days before the match. (We keep a 7-day history).
We have several bookmakers and it can filter the odds by leagues, matches or bookmakers.

Overview of available odds (non-exhaustive list).
To see all odds list, call the "/v2/odds/labels/" endpoint

  • Match Winner
  • Home/Away
  • First Half Winner
  • Second Half Winner
  • Both Teams Score
  • Exact Score
  • Double Chance
  • Results/Both Teams Score
  • ...and more

API - NEWS

For the news of our API, new competitions, features etc … NEWS

API - SUPPORT

For a better support, contact us at : [email protected]

API - DEMO

A demo version of the API is available at this url : https://www.api-football.com/demo/api/v2/.

Here are the leagues present in the demo version :

Champions League (2018-2019)
Brazil - Serie A (2018)
England - Premier League (2018-2019)
Netherlands - Eredivisie (2018-2019)

You can use it without restriction in your development environment.

This is a demo and does not represent the entire API. The data is limited and not up to date and serves only as an example. For production environement use : https://api-football-v1.p.rapidapi.com/v2/.

ARCHITECTURE

COMPETITIONS

Competition Livescore Events Lineups Statistics Standings Odds
Africa Cup of Nations X X X
Asian Cup X X X X
Champions League X X X X X X
Copa America X X X
Euro Championship X X X X X X
Europa League X X X X X X
UEFA Nations League X X X X X
World Cup X X X X X X
World Cup Women X X X X X X
Albania - Superliga ? ? ? ? ? ?
Albania - 1st Division ? ? ? ? ? ?
Algeria - Ligue 1 X X X
Algeria - Ligue 2 Final Result Only X
Andorra - 1a Divisió ? ? ? ? ? ?
Andorra - 2a Divisió ? ? ? ? ? ?
Argentina - Copa Argentina X X X
Argentina - Primera Division X X X X X X
Argentina - Primera B Nacional Final Result Only X X
Australia - A-League X X X X
Australia - National Premier Leagues X X
Australia - W-League X X X
Austria - Erste Liga X X X X
Austria - Tipp3 Bundesliga X X X X
Belarus - Vyscha Liga X X X X
Belarus - 1. Division X X X X
Belgium - Jupiler Pro League X X X X X
Belgium - 2e Klasse X X X X X
Belgium - Super League Women X X X
Bosnia - Premijer Liga ? ? ? ? ? ?
Bosnia - Cup ? ? ? ? ? ?
Brazil - Copa Do Brasil Final Result Only
Brazil - Serie A X X X X X
Brazil - Serie B X X X X
Brazil - Brasileiro Women X X X
Bulgaria - A PFG X X X X
Bulgaria - B PFG Final Result Only X
Canada - Canadian Soccer League X X
Canada - Pacific Coast Soccer League ? ? ? ? ? ?
Canada - Canadian Championship X X X
Chile - Primera Division X X X
Chile - Primera B Final Result Only X
China - Super League X X X X
China - League One X X X
Colombia - Primera A X X X X X
Colombia - Primera B Final Result Only X
Costa-Rica - Primera Division X X X
Costa-Rica - Liga De Ascenso Final Result Only X
Croatia - Prva HNL X X X X
Croatia - Druga HNL X X
Cyprus - 1. Division ? ? ? ? ? ?
Cyprus - 2. Division ? ? ? ? ? ?
Cyprus - 3. Division ? ? ? ? ? ?
Denmark - Superligaen X X X X X
Denmark - Viasat Divisionen X X X
Ecuador - Serie A X X X X
Ecuador - Serie B X X
Egypt - Premier League X X X
England - Premier League X X X X X X
England - Championship X X X X X
England - League One X X X X X
England - League Two X X X X X
England - National League X X X X X
England - FA WSL X X X
Estonia - Meistriliiga ? ? ? ? ? ?
Estonia - Esiliiga A ? ? ? ? ? ?
Finland - Veikkausliiga X X X
Finland - Ykkonen X X X
France - Ligue 1 X X X X X X
France - Ligue 2 X X X X X
France - National X X X X
France - Feminine Division 1 X X X X
France - Coupe de France X X X X X X
France - Coupe de la ligue X X X X X X
Georgia - Erovnuli Liga ? ? ? ? ? ?
Georgia - Erovnuli Liga 2 ? ? ? ? ? ?
Germany - Bundesliga 1 X X X X X X
Germany - Bundesliga 2 X X X X X
Germany - Liga 3 X X X X
Germany - DFB Pokal X X X X X
Germany - Women Bundesliga X X X
Greece - Super League X X X X X X
Greece - Football League X X X
Honduras - Liga Nacional de Fútbol X X X
Hungary - NB I X X X X
Hungary - NB II X X
Iceland - Premier X X X X X
Iceland - Division 1 X X X
Indonesia - Super League X X X
Italy - Serie A X X X X X X
Italy - Serie B X X X X X X
Italy - Serie C X X X
Italy - Coppa Italia X X X
Italy - Serie A Women X X X
Iran - Persian Gulf Cup X X X
Iran - Azadegan League Final Result Only X
Jamaica - Premier League ? ? ? ? ? ?
Japan - J. League Div.1 X X X X
Japan - J. League Div.2 X X X
Kenya - Premier League X X X
Kenya - Super League Final Result Only X
Kuwait - Premier League ? ? ? ? ? ?
Kuwait - Division 1 ? ? ? ? ? ?
Luxembourg - National Division X X X
Malaysia - Super League X X X
Malaysia - Premier League Final Result Only X
Mexico - Liga MX X X X X
Mexico - Ascenso MX X X
Morocco - Botola Pro X X X X
Netherlands - KNVB Beker X X
Netherlands - Eredivisie X X X X X X
Netherlands - Eerste Divisie X X X X
Netherlands - Eredivisie Women X X X
New-Zealand - Football Championship X X
Norway - Eliteserien X X X X X
Norway - OBOS-ligaen X X X
Panama - Liga Panameña de Fútbol X X X
Paraguay - Primera Division X X X
Paraguay - Segunda Division X X
Peru - Primera Division X X X
Peru - Segunda Division X X
Poland - Ekstraklasa X X X X X X
Poland - I Liga ? ? ? ? ? ?
Portugal - Primeira Liga X X X X X
Portugal - Liga de Honra X X X X
Qatar - Stars League X X X
Qatar - 2nd Division League X X
Romania - Liga I X X X X
Romania - Liga II X X X
Russia - Premier League X X X X X
Russia - Football National League X X X
Saudi Arabia - Pro League X X X
Saudi Arabia - Division 1 Final Result Only X
Saudi Arabia - Division 2 Final Result Only X
Scotland - Premiership X X X X X
Scotland - Championship X X X X
Serbia - Super Liga X X X
Serbia - Prva Liga Final Result Onlly X
Slovakia - Super Liga ? ? ? ? ? ?
South-Africa - Premier Soccer League X X X
South-Africa - National First Division Final Result Only X
South-Korea - K-League Classic X X X
South-Korea - K-League Challenge X X X
Spain - Primera Division X X X X X X
Spain - Segunda Division X X X X
Spain - Primera Division Women X X X
Sweden - Allsvenskan X X X X X
Sweden - Superettan X X X
Switzerland - Super League X X X X X X
Switzerland - Challenge League X X X
Thailand - Thai Premier League X X X
Thailand - Thai League 2 Final Result Only X
Tunisia - Ligue Professionnelle 1 X X X
Turkey - Super Lig X X X X X X
Turkey - TFF 1. Lig ? ? ? ? ? ?
Turkey - TFF 2. Lig ? ? ? ? ? ?
Ukraine - Premier League ? ? ? ? ? ?
Ukraine - Persha Liga ? ? ? ? ? ?
United-Arab-Emirates - Arabian Gulf League X X X
United-Arab-Emirates - League Cup X X X
Uruguay - Primera Division X X X
Uruguay - Segunda Division X X
USA - Major League Soccer X X X
USA - NWSL Women X X X
Venezuela - Primera Division X X X
Venezuela - Segunda Division Final Result Only X
Wales - Premier X X X X
Wales - Division 1 Final Result Only X
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/fixtures/date/{date}")
.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