← Tools Reference

API-SPORTS

API-SPORTS integration (Data). Imported from open-connector.

API key14 toolshttps://v3.football.api-sports.io
GET
api_sports_football_list_leagues
Query football leagues by league, country, season or search keyword and return the current available data coverage capabilities.

/leagues

10 parameters
ParamTypeRequiredDescription
idintegeroptionalLeague ID.
namestringoptionalLeague name.
countrystringoptionalThe name of the country to which the league belongs.
codestringoptionalThe country code of the league.
seasonintegeroptionalSeason year, represented by a four-digit number.
teamintegeroptionalTeam ID.
typestringoptionalLeague type.
currentbooleanoptionalWhether to return only the current season league.
searchstringoptionalLeague or country search keywords.
lastintegeroptionalNumber of recently added leagues.
GET
api_sports_football_list_teams
Search football teams by league, season, country, stadium or search keyword.

/teams

8 parameters
ParamTypeRequiredDescription
idintegeroptionalTeam ID.
namestringoptionalTeam name.
leagueintegeroptionalLeague ID.
seasonintegeroptionalSeason year, represented by a four-digit number.
countrystringoptionalThe name of the country to which the team belongs.
codestringoptionalTeam code.
venueintegeroptionalStadium ID.
searchstringoptionalTeam or country search keywords.
GET
api_sports_football_list_players_profiles
Search football player profiles by player ID, search keyword or pagination page number.

/players/profiles

3 parameters
ParamTypeRequiredDescription
playerintegeroptionalPlayer ID.
searchstringoptionalPlayer name search keyword.
pageintegeroptionalPagination page number, starting from 1.
GET
api_sports_football_list_fixtures
Check football schedules and scores by game, league, team, date, live status or time range.

/fixtures

15 parameters
ParamTypeRequiredDescription
idintegeroptionalContest ID.
idsarrayoptionalOne or more contest IDs, up to 20.
livestringoptionalLive match filters.
datestringoptionalDate in YYYY-MM-DD format.
leagueintegeroptionalLeague ID.
seasonintegeroptionalSeason year, represented by a four-digit number.
teamintegeroptionalTeam ID.
lastintegeroptionalThe number of recent games.
nextintegeroptionalNumber of games in the future.
fromstringoptionalDate in YYYY-MM-DD format.
tostringoptionalDate in YYYY-MM-DD format.
roundstringoptionalRound name.
statusarrayoptionalOne or more game status short codes.
venueintegeroptionalStadium ID.
timezonestringoptionalIANA time zone name.
GET
api_sports_football_get_standings
Query the football standings for a specified season, and the results can be converged by league or team.

/standings

3 parameters
ParamTypeRequiredDescription
leagueintegeroptionalLeague ID.
teamintegeroptionalTeam ID.
seasonintegerrequiredSeason year, represented by a four-digit number.
GET
api_sports_football_get_fixture_events
Query the event stream for a specified football match, such as goals, red and yellow cards, substitutions, and VAR.

/fixtures/events

4 parameters
ParamTypeRequiredDescription
fixtureintegerrequiredContest ID.
teamintegeroptionalTeam ID.
playerintegeroptionalPlayer ID.
typestringoptionalEvent or lineup filter type.
GET
api_sports_football_get_fixture_lineups
Query the lineup, formation, starting lineup, substitutes and coaching information for a specified football game.

/fixtures/lineups

4 parameters
ParamTypeRequiredDescription
fixtureintegerrequiredContest ID.
teamintegeroptionalTeam ID.
playerintegeroptionalPlayer ID.
typestringoptionalEvent or lineup filter type.
GET
api_sports_football_get_fixture_statistics
Query the technical statistics of the specified football match, optionally returning the statistics of the first and second halves.

/fixtures/statistics

4 parameters
ParamTypeRequiredDescription
fixtureintegerrequiredContest ID.
teamintegeroptionalTeam ID.
typestringoptionalStatistical item type.
halfbooleanoptionalWhether to return first and second half statistics.
GET
api_sports_football_get_team_statistics
Query the overall statistical performance of a specified team in a certain league season.

/teams/statistics

4 parameters
ParamTypeRequiredDescription
leagueintegerrequiredLeague ID.
seasonintegerrequiredSeason year, represented by a four-digit number.
teamintegerrequiredTeam ID.
datestringoptionalDate in YYYY-MM-DD format.
GET
api_sports_football_list_team_squad
Query the current lineup of the specified team.

/players/squads

1 parameter
ParamTypeRequiredDescription
teamintegerrequiredTeam ID.
GET
api_sports_football_list_players_statistics
Query player season statistics by player, team or league, support paging and search.

/players

6 parameters
ParamTypeRequiredDescription
idintegeroptionalPlayer ID.
teamintegeroptionalTeam ID.
leagueintegeroptionalLeague ID.
seasonintegeroptionalSeason year, represented by a four-digit number.
searchstringoptionalPlayer name search keyword.
pageintegeroptionalPagination page number, starting from 1.
GET
api_sports_football_list_top_scorers
Query the scorer list of the specified league season.

/players/topscorers

2 parameters
ParamTypeRequiredDescription
leagueintegerrequiredLeague ID.
seasonintegerrequiredSeason year, represented by a four-digit number.
GET
api_sports_football_list_injuries
Check football injury information by game, league, team, player or date.

/injuries

8 parameters
ParamTypeRequiredDescription
leagueintegeroptionalLeague ID.
seasonintegeroptionalSeason year, represented by a four-digit number.
fixtureintegeroptionalContest ID.
teamintegeroptionalTeam ID.
playerintegeroptionalPlayer ID.
datestringoptionalDate in YYYY-MM-DD format.
idsarrayoptionalOne or more contest IDs, up to 20.
timezonestringoptionalIANA time zone name.
GET
api_sports_football_get_predictions
Check official predictions and recommendations for selected football matches.

/predictions

1 parameter
ParamTypeRequiredDescription
fixtureintegerrequiredContest ID.