All integrationsSports
API-Football
Follow football with API-Football: fixtures and live scores, league tables, lineups, match events and statistics, team and player season statistics, injuries, transfers, predictions and bookmakers' odds, across more than 1,200 leagues and cups.
- actions
- 31
Actions
Steps a workflow can run in API-Football.
- Get account statusSee the connected key's API-Football plan, when it renews, and how many of today's requests are used and left. Free for a key from API-Football's dashboard; for a RapidAPI key it costs one request and reports the daily allowance only.
- List countriesList the countries that have competitions in API-Football, each with its code and flag. The names are what the Country filters elsewhere take.
- Find leagues and cupsFind competitions by name, country, season, team or type, each with its ID, logo, country and every season on file: its dates, whether it is current, and what data it has (standings, lineups, statistics, odds and more). With no filter it lists all of the 1,200 or so.
- Find teamsFind teams by name, league and season, country, three-letter code or venue, each with its ID, logo, founding year and home ground. A team's ID is the same in every competition.
- Get team statisticsGet a team's season in one competition: matches won, drawn and lost home and away, goals scored and conceded with averages and when they came, clean sheets, biggest wins, longest runs, penalties, formations used and cards. Set a date to see the season up to that day.
- Find venuesFind stadiums by name, city or country, each with its address, capacity, pitch surface and a photo.
- Find coachesFind a coach by name, by the team they coach, or by ID, with their age, nationality, current team and every job on record.
- Get standingsGet a league table: each team's rank, points, goal difference, form, and home and away record, and what each place leads to (the Champions League, relegation and so on). A group stage has a table per group. Give a team instead of a league for its line in every competition it plays.
- List roundsList a season's rounds in order, such as Regular Season - 1 or Quarter-finals, with the days each is played on if asked, or only the current round. A round's name is what List fixtures takes as its Round.
- List fixturesList fixtures and results by day or date range, league and season, team, round, venue or status, or a team's or league's last or next few. Each has its kick-off, status, venue, referee, teams, and the score at half time, full time, extra time and penalties.
- List live fixturesList the fixtures being played right now, everywhere or in some leagues, with the score, the minute, and the goals, cards and substitutions so far. Updated every 15 seconds.
- Get a fixtureGet one fixture by ID with everything API-Football has on it, in a single request: the score and status, the goals, cards and substitutions, both lineups, both sides' statistics, and every player's statistics and rating.
- List head-to-head fixturesList every meeting of two teams in any competition, or only in one league, season, date range or status, or the last or next few, with a count of each side's wins, the draws and the goals across the finished ones.
- Get fixture statisticsGet each side's statistics for a fixture: shots on and off target, possession, passes and accuracy, fouls, corners, offsides, cards, saves and expected goals, as numbers. Can split them by half, from the 2024 season on.
- Get fixture eventsGet a fixture's timeline: goals with the assist, cards, substitutions and VAR decisions, each with its minute and added time. Can narrow to one team, one player or one kind. Updated every 15 seconds during a match.
- Get fixture lineupsGet each side's formation, coach, starting eleven with each player's place on the pitch, and substitutes. Usually there 20 to 40 minutes before kick-off; for some competitions only after the match.
- Get fixture player statisticsGet every player's statistics for a fixture, side by side: minutes, rating, goals, assists, shots, passes, tackles, duels, dribbles, fouls, cards and penalties.
- Get predictionsGet API-Football's forecast for a fixture: the likely winner, the chance of a home win, draw and away win, goal lines, advice in words, how the two sides compare on form, attack and defence, and their previous meetings. Based on statistics, not bookmakers' odds.
- List injuriesList players missing, or at risk of missing, fixtures through injury or suspension, and why, by fixture, league, team, player or day. Give a league, team or player together with a season.
- Get player statisticsGet players' season statistics, a line per team and competition: appearances, minutes, rating, goals, assists, shots, passes, tackles, duels, dribbles, fouls, cards and penalties. For a player, or a team's or league's players, with a season; 20 players a page.
- Find playersFind players by surname, or read one player's profile by ID: name, age, date and place of birth, nationality, height, weight, shirt number, position and photo. 250 players a page.
- Get a team's squadGet a team's current squad: each player's ID, name, age, shirt number, position and photo.
- List a player's teamsList every team a player has played for, clubs and national sides, with the seasons at each.
- List top playersList a competition's top 20 players in a season by goals, assists, yellow cards or red cards, each with their full season statistics.
- List transfersList a player's transfers, or every transfer into and out of a team, newest first: the date, the fee or type (Free, Loan and so on), and the teams the player left and joined.
- List trophiesList the trophies a player or a coach has won, and their other placings, with the competition, country and season.
- List sidelined periodsList every injury and suspension on record for a player or a coach, with when each started and ended.
- Get pre-match oddsGet bookmakers' pre-match odds for a fixture, a league and season, or a day, optionally from one bookmaker or for one bet type. Odds appear 1 to 14 days before kick-off and are kept for 7 days. 10 fixtures a page.
- Get live oddsGet in-play odds for fixtures under way, or one fixture, league or bet type, with the score and clock they were priced at and whether betting is paused. Fixtures appear shortly before kick-off and none are kept once a match ends.
- List bookmakersList the bookmakers API-Football has odds from, with the IDs the odds actions filter on.
- List bet typesList the bet types of pre-match or in-play odds, such as Match Winner or Goals Over/Under, with the IDs the odds actions filter on. The two kinds of odds number their bet types separately.
No actions match that.
Automate API-Football with Lodol.
Connect API-Football and ask your AI for your first workflow.
Free plan, no credit card