API-FOOTBALL.COM

api-football.com

A RESTFUL API FOR FOOTBALL DATA | LIVESCORE | FIXTURES | TEAMS | STANDINGS | ODDS | EVENTS | LINE UPS

get Started

Coverage

We cover all major and minor competions for now, with livescore, standings, events, line-ups, 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"
      },
	  {...}
    }
  }
}

View the full documentation