Api Sports

Learn how to use Api Sports with Composio

Overview

Enum

API_SPORTS

Description

API-Sports provides comprehensive sports data APIs covering over 2,000 competitions with more than 15 years of historical data, offering real-time updates and easy integration for developers.

Authentication Details

api_key
stringRequired

Actions

Tool to retrieve football fixtures/matches. use when filtering fixtures by id, date, league, season, team, or date ranges to get upcoming or past matches.

Action Parameters

date
string
from
string
id
integer
last
integer
league
integer
live
string
next
integer
round
string
season
integer
status
string
team
integer
timezone
string
to
string
venue
integer

Action Response

data
object
error
string
successful
boolean
Tool to get events (goals, cards, substitutions, var, etc.) from a fixture. use when you need detailed event data after confirming the fixture id.

Action Parameters

fixture
integerRequired
player
integer
team
integer
type
string

Action Response

data
object
error
string
successful
boolean
Tool to get head-to-head fixtures between two teams. use after determining team ids to compare their direct match history.

Action Parameters

date
string
from
string
h2h
stringRequired
last
integer
league
integer
next
integer
season
integer
status
string
timezone
string
to
string

Action Response

data
object
error
string
successful
boolean
Tool to retrieve starting xi and substitutes for a fixture. use after confirming fixture id; optionally filter by team, player, or section (startxi/substitutes). lineups appear ~20-40 minutes before kickoff for supported competitions.

Action Parameters

fixture
integerRequired
player
integer
team
integer
type
string

Action Response

data
object
error
string
successful
boolean
Tool to get statistics for a fixture. use when you need detailed match stats (shots, fouls, possession, cards, passes, etc.), optionally filtered by team, statistic type, or including halftime data.

Action Parameters

fixture
integerRequired
half
boolean
team
integer
type
string

Action Response

data
object
error
string
successful
boolean
Tool to get injured or suspended players. use when you need a list of sidelined players filtered by league, season, fixture, team, player, date, ids, or timezone.

Action Parameters

date
string
fixture
integer
ids
string
league
integer
player
integer
season
integer
team
integer
timezone
string

Action Response

data
object
error
string
successful
boolean
Tool to retrieve leagues and cups. use when filtering competitions by id, name, country, code, season, team, type, current, search, or last.

Action Parameters

code
string
country
string
current
boolean
id
integer
last
integer
name
string
search
string
season
integer
team
integer
type
string

Action Response

data
object
error
string
successful
boolean
Tool to get the list of available seasons for all leagues. use when you need season filters for other league endpoints.

Action Parameters

Action Response

data
object
error
string
successful
boolean
Tool to fetch pre-match odds. use when you need odds filterable by fixture, league, season, date, timezone, bookmaker, bet, or to navigate pages.

Action Parameters

bet
integer
bookmaker
integer
date
string
fixture
integer
league
integer
page
integerDefaults to 1
season
integer
timezone
string

Action Response

data
object
error
string
successful
boolean
Tool to fetch in-play odds for fixtures in progress. use during live matches to get in-play odds.

Action Parameters

bet
integer
fixture
integer
league
integer

Action Response

data
object
error
string
successful
boolean
Tool to get player statistics. use when fetching players by id, team, league, season, search, or pagination.

Action Parameters

id
integer
league
integer
page
integer
search
string
season
integer
team
integer

Action Response

data
object
error
string
successful
boolean
Tool to get the list of all available players. use when you need player profiles optionally filtered by id, name search, or page.

Action Parameters

page
integerDefaults to 1
player
integer
search
string

Action Response

data
object
error
string
successful
boolean
Tool to list all available seasons for player statistics. use when building a player statistics query, optionally filtering by a specific player id.

Action Parameters

player
integer

Action Response

data
object
error
string
successful
boolean
Tool to get the list of teams and seasons in which a player played during his career. use after confirming the player id to retrieve club history.

Action Parameters

player
integerRequired
season
integer

Action Response

data
object
error
string
successful
boolean
Tool to get the 20 best players (top scorers) for a league or cup. use after confirming league and season.

Action Parameters

league
integerRequired
page
integer
season
integerRequired
team
integer

Action Response

data
object
error
string
successful
boolean
Tool to retrieve available teams. use when filtering teams by id, name, league, season, country, code, venue, or search before fetching detailed team data.

Action Parameters

code
string
country
string
id
integer
league
integer
name
string
search
string
season
integer
venue
integer

Action Response

data
object
error
string
successful
boolean
Tool to get detailed statistics of a team for a given league and season. use after confirming league, season, and team id.

Action Parameters

date
string
from
string
league
integerRequired
season
integerRequired
team
integerRequired
to
string
venue
string

Action Response

data
object
error
string
successful
boolean
Tool to fetch coaches and their career history. use when you need coach info by id, team filter, or name search.

Action Parameters

id
integer
search
string
team
integer

Action Response

data
object
error
string
successful
boolean
Tool to fetch available countries for league queries. use when filtering by name, code, or search string before retrieving leagues.

Action Parameters

code
string
name
string
search
string

Action Response

data
object
error
string
successful
boolean
Tool to get player statistics from a fixture. use when you need detailed per-player stats for a specific match. optionally filter by team.

Action Parameters

fixture
integerRequired
team
integer

Action Response

data
object
error
string
successful
boolean
Tool to get the rounds for a league or cup. use after confirming league and season to retrieve available round identifiers (optionally with dates) for filtering fixtures.

Action Parameters

current
boolean
dates
boolean
league
integerRequired
season
integerRequired
timezone
string

Action Response

data
object
error
string
successful
boolean
Tool to get all available pre-match bet types. use when filtering by bet id or searching bet names before fetching odds.

Action Parameters

id
integer
search
string

Action Response

data
object
error
string
successful
boolean
Tool to list all available pre-match bookmakers. use when you need to discover or filter bookmakers before fetching odds.

Action Parameters

id
integer
search
string

Action Response

data
object
error
string
successful
boolean
Tool to fetch all available bet types for in-play odds. use when you need to retrieve bet ids or names (optionally filtering by id or search) before fetching live odds.

Action Parameters

id
integer
search
string

Action Response

data
object
error
string
successful
boolean
Tool to get the 20 best players (top assists) for a league or cup. use after confirming league and season.

Action Parameters

league
integerRequired
page
integer
season
integerRequired
team
integer

Action Response

data
object
error
string
successful
boolean
Tool to get the 20 players with the most yellow cards for a league or cup. use after confirming league and season.

Action Parameters

league
integerRequired
page
integer
season
integerRequired
team
integer

Action Response

data
object
error
string
successful
boolean
Tool to get predictions about a fixture. use when you need calculated predictions for a given fixture id.

Action Parameters

fixture
integerRequired

Action Response

data
object
error
string
successful
boolean
Tool to get sidelined information (injuries, suspensions, etc.). use when you need current sidelined records filtered by league, season, team, player, or type.

Action Parameters

league
integer
player
integer
season
integer
team
integer
type
string

Action Response

data
object
error
string
successful
boolean
Tool to fetch the complete list of available timezones for fixture queries. use when you need valid timezone identifiers (e.g., 'europe/london') before calling fixtures endpoints.

Action Parameters

Action Response

data
object
error
string
successful
boolean
Tool to get all available transfers for players and teams. use when you need transfer history filtered by player or team.

Action Parameters

player
integer
season
integer
team
integer

Action Response

data
object
error
string
successful
boolean
Tool to get trophies for a player or coach. use when you need to list honors filtered by player(s) or coach(es).

Action Parameters

coach
integer
coachs
string
player
integer
players
string

Action Response

data
object
error
string
successful
boolean