REST API serving football leagues, fixtures, live scores, players, and teams.

At the moment this API is only accessible via RapidAPI.

Every request must contain the header "X-RapidAPI-Key: YOUR_API_KEY".

Find your Rapid API KEY here: https://rapidapi.com/epsi/api/football536

Getting started

To get started find your Rapid API key here: https://rapidapi.com/epsi/api/football536.

Then you can open a terminal and check what are the available leagues by running this command:

$ curl 'https://football536.p.rapidapi.com/leagues' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

With the 'ID' of a league it is now possible to search for teams and fixtures. For example, if the "Serie A" league has ID=1, we can list all fixtures with:

$ curl 'https://football536.p.rapidapi.com/fixtures?league_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

To list all teams of the "Serie A" league:

$ curl 'https://football536.p.rapidapi.com/teams?season_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

List all today’s fixtures including live fixtures:

$ curl 'https://football536.p.rapidapi.com/fixtures?date_from=today&date_to=today' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

List all squads of a team, including all players:

$ curl 'https://football536.p.rapidapi.com/squads?team_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

For more details, check the full documentation below.

League API

A league can have many seasons. For example, the league "Serie A" has season 2022-23, 2023-24, etc.

List all leagues

Curl request

$ curl 'https://football536.p.rapidapi.com/leagues' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Response body

[ {
  "id" : 1,
  "name" : "Serie A",
  "area" : "Italy"
}, {
  "id" : 2,
  "name" : "UEFA Europa League",
  "area" : "Europe"
} ]

Get a league by ID

Curl request

$ curl 'https://football536.p.rapidapi.com/leagues/1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Response body

{
  "id" : 1,
  "name" : "Serie A",
  "area" : "Italy"
}

Season API

A season can have many rounds. For example, the season "Serie A 2023-24" has round "Giornata 1", "Giornata 2", etc.

List seasons

Curl request

$ curl 'https://football536.p.rapidapi.com/seasons?league_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Query parameters

Parameter Required Description

league_id

Yes

The league ID of the season.

name

The name of the season.

Response body

[ {
  "id" : 1,
  "name" : "Serie A 2023-24",
  "league" : {
    "id" : 1,
    "name" : "Serie A"
  },
  "start_date" : "2023-09-20",
  "end_date" : "2024-05-24"
} ]

Get a season by ID

Curl request

$ curl 'https://football536.p.rapidapi.com/seasons/1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Path parameters

Table 1. /football/v1/seasons/{id}
Parameter Description

id

The ID of the season.

Response body

{
  "id" : 1,
  "name" : "Serie A 2023-24",
  "league" : {
    "id" : 1,
    "name" : "Serie A"
  },
  "start_date" : "2023-09-20",
  "end_date" : "2024-05-24"
}

Round API

A round is can have fixtures or groups.

List rounds

Curl request

$ curl 'https://football536.p.rapidapi.com/rounds?season_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Query parameters

Parameter Required Description

season_id

Yes

The season ID of the round.

name

The name of the round.

Response body

[ {
  "id" : 1,
  "name" : "Play-off",
  "start_date" : "2023-09-01",
  "end_date" : "2023-12-15",
  "season" : {
    "id" : 1,
    "name" : "Uefa Europa League"
  }
} ]

Get a round by ID

Curl request

$ curl 'https://football536.p.rapidapi.com/rounds/1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Path parameters

Table 1. /football/v1/rounds/{id}
Parameter Description

id

The ID of the round.

Response body

{
  "id" : 1,
  "name" : "Play-off",
  "start_date" : "2023-09-01",
  "end_date" : "2023-12-15",
  "season" : {
    "id" : 1,
    "name" : "Serie A 2023-24"
  }
}

Fixture API

A fixture is a match between two teams.

List fixtures

Curl request

$ curl 'https://football536.p.rapidapi.com/fixtures?league_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Query parameters

Parameter Required Description

league_id

The league ID of the fixtures.

round_id

The round ID of the fixtures.

group_id

The round ID of the fixtures.

date_from

Search all fixtures from this date

date_to

Search all fixtures until this date

status

The status can be SCHEDULED, FINISHED, LIVE, POSTPONED, CANCELLED.

page

Page number

Response body

{
  "data" : [ {
    "id" : 1,
    "league" : null,
    "round" : {
      "id" : 1
    },
    "group" : null,
    "status" : "FINISHED",
    "start_time" : "2024-06-26T14:40:37.019177800Z",
    "start_date" : null,
    "home_team" : {
      "id" : 1,
      "name" : "Atalanta",
      "country_code" : "ITA"
    },
    "away_team" : {
      "id" : 2,
      "name" : "Roma",
      "country_code" : "ITA"
    },
    "home_goals" : null,
    "away_goals" : null,
    "venue" : {
      "id" : 1,
      "name" : "San Siro",
      "country_code" : "ITA"
    }
  }, {
    "id" : 2,
    "league" : null,
    "round" : {
      "id" : 1
    },
    "group" : null,
    "status" : "SCHEDULED",
    "start_time" : "2024-06-26T14:40:37.019177800Z",
    "start_date" : null,
    "home_team" : {
      "id" : 3,
      "name" : "Napoli",
      "country_code" : "ITA"
    },
    "away_team" : {
      "id" : 4,
      "name" : "Inter",
      "country_code" : "ITA"
    },
    "home_goals" : null,
    "away_goals" : null,
    "venue" : {
      "id" : 2,
      "name" : "Olimpico",
      "country_code" : "ITA"
    }
  } ],
  "number_of_elements" : 2,
  "total_elements" : 2,
  "total_pages" : 1,
  "page_number" : 0
}

Get a fixture by ID

Curl request

$ curl 'https://football536.p.rapidapi.com/fixtures/1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Path parameters

Table 1. /football/v1/fixtures/{id}
Parameter Description

id

The ID of the fixture.

Response body

{
  "id" : 1,
  "league" : null,
  "round" : {
    "id" : 1
  },
  "group" : null,
  "status" : "SCHEDULED",
  "start_time" : "2024-06-26T14:40:36.913498200Z",
  "start_date" : null,
  "home_team" : {
    "id" : 1,
    "name" : "Atalanta",
    "country_code" : "ITA"
  },
  "away_team" : {
    "id" : 2,
    "name" : "Roma",
    "country_code" : "ITA"
  },
  "home_goals" : null,
  "away_goals" : null,
  "venue" : {
    "id" : 1,
    "name" : "San Siro",
    "country_code" : "ITA"
  }
}

Team API

List teams

Curl request

$ curl 'https://football536.p.rapidapi.com/teams?season_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Query parameters

Parameter Required Description

season_id

Yes

The season ID of the team

name

The name of the team. It can be a part of the name.

Response body

{
  "data" : [ {
    "id" : 1,
    "name" : "Atalanta",
    "country_code" : "ITA"
  }, {
    "id" : 2,
    "name" : "Roma",
    "country_code" : "ITA"
  } ],
  "number_of_elements" : 2,
  "total_elements" : 2,
  "total_pages" : 1,
  "page_number" : 0
}

Get a team by ID

Curl request

$ curl 'https://football536.p.rapidapi.com/teams/1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Path parameters

Table 1. /football/v1/teams/{id}
Parameter Description

id

The ID of the team.

Response body

{
  "id" : 1,
  "name" : "Atalanta",
  "country_code" : "ITA"
}

Squad API

A squad is associated to a team and a season.

List squads of a team

Curl request

$ curl 'https://football536.p.rapidapi.com/squads?team_id=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Query parameters

Parameter Required Description

team_id

The team ID of the squad

page

The page number

Response body

{
  "data" : [ {
    "id" : 1,
    "team" : {
      "id" : 1,
      "name" : "AC Milan",
      "country_code" : "ITA"
    },
    "season" : {
      "id" : 1,
      "name" : "Serie A 2023-24"
    },
    "players" : [ {
      "id" : 1,
      "nationality" : "Spain",
      "position" : "MIDFIELDER",
      "birthday" : "2024-09-26",
      "full_name" : "Rafael Leão"
    } ]
  }, {
    "id" : 2,
    "team" : {
      "id" : 1,
      "name" : "AC Milan",
      "country_code" : "ITA"
    },
    "season" : {
      "id" : 1,
      "name" : "Serie A 2023-24"
    },
    "players" : [ {
      "id" : 2,
      "nationality" : "France",
      "position" : "MIDFIELDER",
      "birthday" : "2024-09-26",
      "full_name" : "Olivier Giroud"
    } ]
  } ],
  "number_of_elements" : 2,
  "total_elements" : 2,
  "total_pages" : 1,
  "page_number" : 0
}

Get a squad by ID

Curl request

$ curl 'https://football536.p.rapidapi.com/squads/1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Path parameters

Table 1. /football/v1/squads/{id}
Parameter Description

id

The ID of the squad.

Response body

{
  "id" : 1,
  "team" : {
    "id" : 1,
    "name" : "Atalanta",
    "country_code" : "ITA"
  },
  "season" : {
    "id" : null,
    "name" : "Serie A 2023-24"
  },
  "players" : [ {
    "id" : null,
    "nationality" : "Spain",
    "position" : "MIDFIELDER",
    "birthday" : "2024-09-26",
    "full_name" : "Rafael Leão"
  } ]
}

Player API

Get a player by ID

Curl request

$ curl 'https://football536.p.rapidapi.com/players/1' -i -X GET \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'Accept: application/json' \
    -H 'X-RapidAPI-Key: YOUR-API-KEY'

Path parameters

Table 1. /football/v1/players/{id}
Parameter Description

id

The ID of the player.

Response body

{
  "id" : 1,
  "nationality" : "Spain",
  "position" : "MIDFIELDER",
  "birthday" : "2024-09-26",
  "squads" : [ {
    "id" : 1,
    "team_name" : "AC Milan",
    "team_id" : 1
  } ],
  "full_name" : "Rafael Leão"
}