NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

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 ToolsWeb del proveedor
Acciones
31
Triggers
0
Autenticación
—
OAuth gestionado
No
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