API-Sports

api_sports

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.

Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (31)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Get CoachesAPI_SPORTS_GET_COACHSAcción

Tool to fetch coaches and their career history. use when you need coach info by id, team filter, or name search.

Parámetros de entrada

idinteger
Coach ID to filter by
teaminteger
Team ID to filter coaches by
searchstring
Search term for coach name (min length 3)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get CountriesAPI_SPORTS_GET_COUNTRIESAcción

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

Parámetros de entrada

codestring
Alpha-2 country code to filter by (e.g., 'FR', 'GB').
namestring
Exact country name to filter by (e.g., 'Chile').
searchstring
Partial match search on country name (e.g., 'Uni' for 'United Kingdom').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get FixturesAPI_SPORTS_GET_FIXTURESAcción

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.

Parámetros de entrada

idinteger
Unique identifier of the fixture.
tostring
End date for date range (YYYY-MM-DD).
datestring
A valid date (YYYY-MM-DD).
fromstring
Start date for date range (YYYY-MM-DD).
lastinteger
Number of last fixtures to retrieve.
livestring
Get all live fixtures (all) or only those with events (all-events).
nextinteger
Number of next fixtures to retrieve.
teaminteger
Unique identifier of the team.
roundstring
Round of the fixture.
venueinteger
Unique identifier of the venue.
leagueinteger
Unique identifier of the league.
seasoninteger
Season year (4-digit year).
statusstring
Status of the fixture (NS, LIVE, FT, etc.).
timezonestring
IANA timezone for date conversion.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get fixtures eventsAPI_SPORTS_GET_FIXTURES_EVENTSAcción

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

Parámetros de entrada

teaminteger
ID of the team to filter events by (optional)
typestring
Type of event to filter (e.g., goal, card, substitution, VAR) (optional)
playerinteger
ID of the player to filter events by (optional)
fixtureintegerObligatorio
ID of the fixture to fetch events for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Head-to-Head FixturesAPI_SPORTS_GET_FIXTURES_HEADTOHEADAcción

Tool to get head-to-head fixtures between two teams. use after determining team ids to compare their direct match history.

Parámetros de entrada

tostring
End date for filtering (YYYY-MM-DD)
h2hstringObligatorio
Team IDs in 'ID-ID' format, e.g., '33-34'
datestring
Filter fixtures by a specific date in YYYY-MM-DD format
fromstring
Start date for filtering (YYYY-MM-DD)
lastinteger
Number of most recent past fixtures to retrieve
nextinteger
Number of upcoming fixtures to retrieve
leagueinteger
League ID to filter fixtures
seasoninteger
Season year in YYYY format, e.g., 2020
statusstring
Filter fixtures by status code, e.g., 'FT'
timezonestring
Specify IANA timezone, e.g., 'Europe/London'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Fixture LineupsAPI_SPORTS_GET_FIXTURES_LINEUPSAcción

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.

Parámetros de entrada

teaminteger
Filter by team ID
typestringenum
Filter by lineup section: 'startXI' or 'substitutes'
startXIsubstitutes
playerinteger
Filter by player ID
fixtureintegerObligatorio
Unique ID of the fixture

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get fixtures playersAPI_SPORTS_GET_FIXTURES_PLAYERSAcción

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

Parámetros de entrada

teaminteger
ID of the team to filter player statistics by (optional)
fixtureintegerObligatorio
ID of the fixture to retrieve player statistics for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Fixtures RoundsAPI_SPORTS_GET_FIXTURES_ROUNDSAcción

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.

Parámetros de entrada

datesboolean
If true, include dates of each round in the response
leagueintegerObligatorio
League ID (from /leagues endpoint)
seasonintegerObligatorio
Season year in YYYY format (from /leagues/seasons endpoint)
currentboolean
If true, only return the current round
timezonestring
Valid timezone (IANA) for formatting dates (from /timezone endpoint)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get fixture statisticsAPI_SPORTS_GET_FIXTURES_STATISTICSAcción

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.

Parámetros de entrada

halfboolean
If true, includes halftime statistics in the response. Available for fixtures from the 2024 season onward.
teaminteger
Optional team ID to filter statistics
typestringenum
Statistic type to filter results (must match API's available types)
Shots on GoalShots off GoalShots insideboxShots outsideboxTotal ShotsBlocked ShotsFoulsCorner KicksOffsidesBall PossessionYellow CardsRed Cards+4
fixtureintegerObligatorio
ID of the fixture for which statistics are requested

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get InjuriesAPI_SPORTS_GET_INJURIESAcción

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.

Parámetros de entrada

idsstring
One or more fixture IDs, hyphen-separated (max 20), e.g. '123-456'.
datestring
Date (YYYY-MM-DD) to filter injuries.
teaminteger
Team ID to filter injuries.
leagueinteger
League ID to filter injuries.
playerinteger
Player ID to filter injuries.
seasoninteger
Season (YYYY) required with league, team, or player filters.
fixtureinteger
Fixture ID to filter injuries.
timezonestring
Timezone name from the /timezone endpoint.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get LeaguesAPI_SPORTS_GET_LEAGUESAcción

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

Parámetros de entrada

idinteger
League ID to filter by
codestring
Alpha code of the country (2 to 6 chars)
lastinteger
Number of most recently added leagues or cups to return (1 to 99)
namestring
Name of the league or cup
teaminteger
Team ID to filter leagues in which the team has played
typestringenum
Competition type: 'league' or 'cup'
leaguecup
searchstring
Search term for league name or country (min 3 chars)
seasoninteger
4-digit season year (e.g., 2021)
countrystring
Country name of the competition
currentboolean
Return only currently active competitions (true/false)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get League SeasonsAPI_SPORTS_GET_LEAGUES_SEASONSAcción

Tool to get the list of available seasons for all leagues. use when you need season filters for other league endpoints.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OddsAPI_SPORTS_GET_ODDSAcción

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

Parámetros de entrada

betinteger
Filter odds by bet ID
datestring
Filter odds by date (YYYY-MM-DD)
pageinteger
Page number for pagination (10 results per page)
leagueinteger
Filter odds by league ID
seasoninteger
Filter odds by season (4-digit year)
fixtureinteger
Filter odds by fixture ID
timezonestring
IANA timezone for date conversion, e.g., 'Europe/London'
bookmakerinteger
Filter odds by bookmaker ID

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Odds BetsAPI_SPORTS_GET_ODDS_BETSAcción

Tool to get all available pre-match bet types. use when filtering by bet id or searching bet names before fetching odds.

Parámetros de entrada

idinteger
Filter by bet ID.
searchstring
Partial match search on bet name (minimum 3 characters).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Odds BookmakersAPI_SPORTS_GET_ODDS_BOOKMAKERSAcción

Tool to list all available pre-match bookmakers. use when you need to discover or filter bookmakers before fetching odds.

Parámetros de entrada

idinteger
Filter by bookmaker ID.
searchstring
Partial match search on bookmaker name (minimum 3 characters).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get In-Play OddsAPI_SPORTS_GET_ODDS_LIVEAcción

Tool to fetch in-play odds for fixtures in progress. use during live matches to get in-play odds.

Parámetros de entrada

betinteger
Filter by bet ID for live odds.
leagueinteger
Filter by league ID for live odds.
fixtureinteger
Filter by fixture ID for live odds.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Live Odds BetsAPI_SPORTS_GET_ODDS_LIVE_BETSAcción

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.

Parámetros de entrada

idinteger
Bet ID to filter by.
searchstring
Search term for bet name (min 3 characters).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PlayersAPI_SPORTS_GET_PLAYERSAcción

Tool to get player statistics. use when fetching players by id, team, league, season, search, or pagination.

Parámetros de entrada

idinteger
Unique player ID to filter by
pageinteger
Page number for pagination
teaminteger
Team ID to filter players by
leagueinteger
League ID to filter players by
searchstring
Search term for player name (min 3 chars)
seasoninteger
Season year in YYYY format

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Players ProfilesAPI_SPORTS_GET_PLAYERS_PROFILESAcción

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

Parámetros de entrada

pageinteger
Page number for pagination (default 1)
playerinteger
Filter by specific player ID
searchstring
Search players by last name substring, at least 4 characters

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Players SeasonsAPI_SPORTS_GET_PLAYERS_SEASONSAcción

Tool to list all available seasons for player statistics. use when building a player statistics query, optionally filtering by a specific player id.

Parámetros de entrada

playerinteger
Player id to filter seasons by (optional)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Players TeamsAPI_SPORTS_GET_PLAYERS_TEAMSAcción

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.

Parámetros de entrada

playerintegerObligatorio
Unique ID of the player.
seasoninteger
Season year to filter results (e.g., 2020).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Players Top AssistsAPI_SPORTS_GET_PLAYERS_TOP_ASSISTSAcción

Tool to get the 20 best players (top assists) for a league or cup. use after confirming league and season.

Parámetros de entrada

pageinteger
Page number for pagination
teaminteger
Team ID to filter the top assists leaderboard
leagueintegerObligatorio
League ID to retrieve top assist players for
seasonintegerObligatorio
Season year (e.g., 2023)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Players Top ScorersAPI_SPORTS_GET_PLAYERS_TOP_SCORERSAcción

Tool to get the 20 best players (top scorers) for a league or cup. use after confirming league and season.

Parámetros de entrada

pageinteger
Page number for pagination
teaminteger
Team ID to filter the top scorers leaderboard
leagueintegerObligatorio
League ID to retrieve top scorers for
seasonintegerObligatorio
Season year (e.g., 2023)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Players Top Yellow CardsAPI_SPORTS_GET_PLAYERS_TOP_YELLOW_CARDSAcción

Tool to get the 20 players with the most yellow cards for a league or cup. use after confirming league and season.

Parámetros de entrada

pageinteger
Page number for pagination
teaminteger
Team ID to filter the top yellow cards leaderboard
leagueintegerObligatorio
League ID to retrieve top yellow card players for
seasonintegerObligatorio
Season year (e.g., 2023)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PredictionsAPI_SPORTS_GET_PREDICTIONSAcción

Tool to get predictions about a fixture. use when you need calculated predictions for a given fixture id.

Parámetros de entrada

fixtureintegerObligatorio
Fixture ID to retrieve predictions for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get SidelinedAPI_SPORTS_GET_SIDELINEDAcción

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

Parámetros de entrada

teaminteger
Team ID to filter sidelined records.
typestring
Type of sidelined record (e.g., 'injury', 'suspension').
leagueinteger
League ID to filter sidelined records.
playerinteger
Player ID to filter sidelined records.
seasoninteger
Season year to filter sidelined records.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TeamsAPI_SPORTS_GET_TEAMSAcción

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

Parámetros de entrada

idinteger
Unique identifier of the team.
codestring
Three-letter team code (e.g., 'MUN' for Manchester United).
namestring
Name of the team.
venueinteger
Unique identifier of the team's home venue.
leagueinteger
Unique identifier of the league to filter teams.
searchstring
Search term for team name (min length 3).
seasoninteger
Season year (e.g., 2021).
countrystring
Name of the country the team represents.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get team statisticsAPI_SPORTS_GET_TEAMS_STATISTICSAcción

Tool to get detailed statistics of a team for a given league and season. use after confirming league, season, and team id.

Parámetros de entrada

tostring
End date for filtering stats (YYYY-MM-DD)
datestring
Limit statistics up to a certain date (YYYY-MM-DD)
fromstring
Start date for filtering stats (YYYY-MM-DD)
teamintegerObligatorio
Team ID for which to retrieve statistics
venuestringenum
Filter statistics by venue: 'home' or 'away'
homeaway
leagueintegerObligatorio
League ID for which to retrieve team statistics
seasonintegerObligatorio
Season year of the league (e.g., 2022)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TimezoneAPI_SPORTS_GET_TIMEZONEAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TransfersAPI_SPORTS_GET_TRANSFERSAcción

Tool to get all available transfers for players and teams. use when you need transfer history filtered by player or team.

Parámetros de entrada

teaminteger
Team ID to filter transfers by (optional)
playerinteger
Player ID to filter transfers by (optional)
seasoninteger
Season year to filter transfers by (optional)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TrophiesAPI_SPORTS_GET_TROPHIESAcción

Tool to get trophies for a player or coach. use when you need to list honors filtered by player(s) or coach(es).

Parámetros de entrada

coachinteger
Coach ID to filter trophies by
coachsstring
Dash-separated list of up to 20 coach IDs (e.g. '2-6-44')
playerinteger
Player ID to filter trophies by
playersstring
Dash-separated list of up to 20 player IDs (e.g. '276-278')

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not