-
Report a bug!
This way -
Contact Us
apifootball.contact@gmail.com
Coverage
We cover all major and minor competions for now, with livescore, standings, events, pre-match odds, statistics
Easy integration
We have built a simple architecture to facilitate your developments
Support 24/7
We will answer you as soon as possible. Mail at : apifootball.contact@gmail.com
historical data
Several years of data available, ideal for statistics or for any other project
Pre-match Odds
We provide pre-match odds between one and three days before the match
Livescore
Real-time matches updated every minute. (In all our plans)
Works with
Whathever your programming language, our data works with and remain the same across all plateforms.
You can use our demo version to discover our API : https://www.api-football.com/demo.
Hosted on Mashape
For simplicity and security. Mashape (Kong) is one of the best api platform of the moment.
Request Example
/fixtures/date/{date}
Get all fixtures from one date
URL Parameters
DATE
STRING
Endoint Definition
Test this
https://api-football-v1.p.mashape.com/fixtures/date/{date}
Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/fixtures/date/2018-07-15",
array(
"X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
"Accept" => "application/json"
)
);Response body 200 / JSON
{
"api": {
"results": 16,
"fixtures": {
"1": {
"fixture_id": "1",
"event_timestamp": "1531666800",
"event_date": "2018-07-15T15:00:00+00:00",
"league_id": "1",
"round": "Final",
"homeTeam_id": "2",
"awayTeam_id": "3",
"homeTeam": "France",
"awayTeam": "Croatia",
"status": "Match Finished",
"statusShort": "FT",
"goalsHomeTeam": "4",
"goalsAwayTeam": "2",
"halftime_score": "2 - 1",
"final_score": "4 - 2",
"penalty": null,
"elapsed": "90",
"firstHalfStart": "1531666800",
"secondHalfStart": "1531670400"
},
"4377": {
"fixture_id": "4377",
"event_timestamp": "1531648800",
"event_date": "2018-07-15T10:00:00+00:00",
"league_id": "14",
"round": "J2 League - 23",
"homeTeam_id": "311",
"awayTeam_id": "307",
"homeTeam": "Albirex Niigata",
"awayTeam": "Yokohama FC",
"status": "Match Finished",
"statusShort": "FT",
"goalsHomeTeam": "0",
"goalsAwayTeam": "1",
"halftime_score": "0 - 0",
"final_score": "0 - 1",
"penalty": null,
"elapsed": "90",
"firstHalfStart": "1531648800",
"secondHalfStart": "1531652400"
},
"4378": {
"fixture_id": "4378",
"event_timestamp": "1531648800",
"event_date": "2018-07-15T10:00:00+00:00",
"league_id": "14",
"round": "J2 League - 23",
"homeTeam_id": "318",
"awayTeam_id": "299",
"homeTeam": "Ehime FC",
"awayTeam": "Tokushima Vortis",
"status": "Match Finished",
"statusShort": "FT",
"goalsHomeTeam": "1",
"goalsAwayTeam": "0",
"halftime_score": "0 - 0",
"final_score": "1 - 0",
"penalty": null,
"elapsed": "90",
"firstHalfStart": "1531648800",
"secondHalfStart": "1531652400"
},
{...}
}
}
}