# API-Sports integration

> Read-only sports data API for football/soccer (fixtures, live scores, standings, teams, players, odds, predictions) and other sports, keyed by a single API-Sports account key.

- Authentication: apiKey

## Tools (38)

- **Get API Status**: Get the account name, subscription plan, and daily request usage for the API key.
- **Get Coaches**: Get coach information and career history by id, team, or search. Note the path is /coachs.
- **Get Fixture Events**: Get the timeline of events (goals, cards, subs, VAR) for a fixture.
- **Get Fixture Lineups**: Get starting XI, substitutes, formation, and coach for each team in a fixture.
- **Get Fixture Player Statistics**: Get per-player statistics for a single fixture (minutes, rating, goals, passes, tackles, etc.).
- **Get Fixture Rounds**: List the rounds (matchdays) available for a league and season.
- **Get Fixture Statistics**: Get team statistics for a single fixture (shots, possession, corners, fouls, etc.).
- **Get Head-to-Head Fixtures**: Get past and upcoming fixtures between two teams.
- **Get Injuries**: List injured/suspended players by league+season, fixture, team, player, or date.
- **Get Live In-Play Odds**: Get live in-play odds for matches currently in progress, filtered by fixture, league, or bet.
- **Get Odds Mapping**: List the fixtures for which pre-match odds are available. Paginated.
- **Get Players and Statistics**: Get players with detailed season statistics, filtered by id, team, league, season, or search. Paginated.
- **Get Player Teams**: Get the list of teams and seasons a player has played for across their career.
- **Get Predictions**: Get match prediction (winner, advice, percentages, comparison) for a fixture.
- **Get Pre-Match Odds**: Get pre-match bookmaker odds by fixture, league, or date. Paginated; updated about once a day.
- **Get Sidelined**: Get past and current sidelined periods (injuries/suspensions) for a player or coach.
- **Get Standings**: Get the league standings table for a season, optionally for a single team.
- **Get Teams Information**: Get team information (name, country, founded, venue) filtered by id, league, season, country, or search.
- **Get Team Squads**: Get a team's current squad, or the teams a player belongs to.
- **Get Team Statistics**: Get aggregated statistics for one team in a given league and season (form, goals, wins, clean sheets, etc.).
- **Get Top Assists**: Get the top 20 assist providers for a league and season.
- **Get Top Red Cards**: Get the players with the most red cards for a league and season.
- **Get Top Scorers**: Get the top 20 goal scorers for a league and season.
- **Get Top Yellow Cards**: Get the players with the most yellow cards for a league and season.
- **Get Transfers**: Get transfer history for a player or all transfers in/out of a team.
- **Get Trophies**: Get the trophies won by a player or coach.
- **List Available Seasons (Leagues)**: List all season years available across leagues.
- **List Bookmakers**: List available bookmakers with their ids.
- **List Countries**: List countries available across leagues, optionally filtered by name, code, or search.
- **List Fixtures (Live, By Date, League, or Team)**: List fixtures/matches with scores and status; filter by live, date, league, season, team, round, ids, or next/last N.
- **List Leagues and Cups**: List leagues and cups with their seasons and coverage, filtered by id, country, season, team, type, or search.
- **List Live Bets**: List available live (in-play) bet types with their ids.
- **List Player Profiles**: List player profiles (name, nationality, birth, height, weight), searchable by last name. Paginated.
- **List Player Seasons**: List the seasons for which player statistics are available.
- **List Pre-Match Bets**: List available pre-match bet types with their ids.
- **List Team Countries**: List the countries available for the teams endpoint.
- **List Timezones**: List every timezone string accepted by the timezone parameter on fixtures endpoints.
- **Search Venues**: Look up stadiums/venues by id, name, city, country, or search.

## Triggers (1)

- **New Finished Fixture in API-Football**: Triggers when a fixture finishes (full time, after extra time, or penalties) in a league and season.

## Related prompts

- [Weekend football matchday preview, posted to Slack](https://www.generalinput.com/prompts/weekend-football-matchday-preview-posted-to-slack.md)
- [Weekly matchday preview drafts for your football site](https://www.generalinput.com/prompts/weekly-matchday-preview-drafts-for-your-football-site.md)
- [Log daily football results and league standings to Sheets](https://www.generalinput.com/prompts/log-daily-football-results-and-league-standings-to-sheets.md)
- [Match-day fantasy football injury and lineup brief](https://www.generalinput.com/prompts/match-day-fantasy-football-injury-and-lineup-brief.md)

Connect API-Sports in General Input: https://www.generalinput.com/apps/api-sports