Football Data API Documentation
Search…
Tutorials
Endpoints
Stats Endpoints
League Teams
Stats for all teams that participated in a season of a league. For example, the 20 teams in 2019/20 Premier League season.
get
https://api.football-data-api.com
/league-teams?key=YOURKEY&season_id=*&include=stats
Get Teams in a League Season
You can run an example of this call by using the key "example" and loading the teams from the English Premier League 2018/2019 season (ID: 1625).
Variable
Description
id
ID of the team
name
Name of the Team
cleanName
Shorter version of the Team Name
alt_name1 - 3
Alternative team names
homeAttackAdvantage
Percentage of goals scored more at home than at away
homeDefenceAdvantage
Percentage of goals conceded less at home than at away
homeOverallAdvantage
Overall Attacking and Defensive advantage
seasonGoals_overall
Number of Goals Scored this season
seasonGoals_home / away
Goal timings of the goals scored at home and at away. Array
seasonConceded_overall
Number of Goals Conceded this season
seasonConceded_home / away
Goal timings of the goals conceded at home and at away. Array
seasonGoalsTotal_overall / home / away
Number of goals Scored + Conceded this season. Overall, home, or away
seasonScoredNum_overall / home / away
Number of goals scored. Overall, home, away
seasonConcededNum_overall / home /away
Number of goals conceded. Overall / home / away
seasonGoalsMin_overall / home / away
Minutes per goal. Both scored and conceded. Overall / home / away
seasonScoredMin_overall / home / away
Minutes per goal scored. Overall / home / away
seasonConcededMin_overall / home / away
Minutes per goal conceded. Overall / home / away
seasonGoalDifference_overall / home / away
Goal difference. Overall matches, home, or away
seasonWinsNum_overall / home / away
Number of wins. Overall / home /away
seasonDrawsNum_overall / home / away
Number of draws. Overall / home / away
seasonLossesNum_overall / home / away
Number of losses. Overall / home / away
seasonMatchesPlayed_overall
Number of Matches Played. Overall / home / away
seasonHighestScored_home / away
Highest number of goals scored in a game. Home /away
seasonHighestConceded_home / away
Highest number of goals conceded in a game. Home / away
seasonCS_overall / home / away
Number of clean sheets this season. Overall / home /away
seasonCSPercentage_overall / home / away
Percentage of clean sheets matches.
seasonCSHT_overall / home / away
Number of Clean sheets at half time
seasonCSPercentageHT_overall / home /away
Percentage of matches with clean sheets at half time
seasonFTS_overall / home / away
Number of matches where this team failed to score.
seasonFTSPercentage_overall / home / away
Percentage of matches where this team failed to score
seasonFTSHT_overall / home / away
Number of matches where this team failed to score by half time.
seasonFTSPercentageHT_overall / home / away
Percentage of matches where this team failed to score by half time
seasonBTTS_overall / home /away
Number of both teams scored matches this season
seasonBTTSPercentage_overall / home / away
Percentage of matches that ended as BTTS
seasonBTTSHT_overall / home /away
Number of both teams scored matches by HT this season
seasonBTTSPercentageHT_overall / home /away
Percentage of matches that ended as BTTS by half time
seasonPPG_overall / home / away
Points Per Game
seasonAVG_overall / home /away
Average total goals per game. Goal is total between both teams.
seasonScoredAVG_overall / home /away
Average goals scored per game
seasonConcededAVG_overall / home /away
Averages goals conceded per game
winPercentage_overall / home /away
Win Percentage this season
drawPercentage_overall / home /away
Draw percentage this season
losePercentage_overall / home /away
Loss percentage this season
leadingAtHT_overall / home /away
Number of times this team was Leading at HT this season
leadingAtHTPercentage_overall / home / away
Percentage of matches this team was leading at HT this season
drawingAtHT_overall / home / away
Number of times this team was drawing at HT
drawingAtHTPercentage_overall /home / away
Percentage of matches where this team was drawing at HT
trailingAtHT_overall / home / away
Number of matches that ended with the team trailing at HT
trailingAtHTPercentage_overall / home / away
Percentage of matches that ended with the team trailing at HT
HTPoints_overall / home / away
Points accumulated this season if matches ended at HT
HTPPG_overall / home /away
Points per game this season if matches ended at HT
scoredAVGHT_overall / home / away
Average number of goals scored by Half Time
concededAVGHT_overall / home / away
Average number of goals conceded by Half Time
AVGHT_overall / home /away
Average total goals per match at half time
scoredGoalsHT_overall / home /away
Number of goals scored by half time this season
concededGoalsHT_overall / home /away
Number of goals conceded by half time this season
GoalsHT_overall / home /away
Number of total goals by half time this season. Scored and conceded
GoalDifferenceHT_overall / home /away
Goal difference at Half Time
seasonOver05Num_overall - seasonOver55Num_overall / home / away
Number of times the matches ended with Over 0.5 - 5.5 this season
seasonOver05Percentage_overall - seasonOver55Percentage_overall / home /away
Percentage of matches that ended with Over 0.5 - 5.5 this season
seasonUnder05Num_overall - seasonUnder55Num_overall / home / away
Number of times the matches ended with Under 0.5 - 5.5 this season
seasonUnder05Percentage_overall - seasonUnder55Percentage_overall / home /away
Percentage of matches that ended with Under 0.5 - 5.5 this season
seasonOver05NumHT_overall - seasonOver25NumHT_overall / home /away
Number of matches ending with Over 0.5 - 2.5 by HT
seasonOver05PercentageHT_overall - seasonOver25PercentageHT_overall / home / away
Percentage of matches that ended with Over 0.5 - 2.5 by HT
cornersRecorded_matches_overall / home / away
Number of matches this season where Corners were recorded
over65Corners_overall - over145Corners_overall / home /away
Number of matches this season that ended with Over X corners (Total Corners)
over65CornersPercentage_overall - over145CornersPercentage_overall / home / away
Percentage of matches this season that ended with Over X corners (Total Corners)
over25CornersFor_overall - over85CornersFor_overall / home / away
Number of matches this season that ended with Over X corners for (Corners earned)
over25CornersForPercentage_overall - over85CornersForPercentage_overall / home / away
Percentage of matches this season that ended with Over X corners for
over25CornersAgainst_overall - over85CornersAgainst_overall / home / away
Number of matches this season that ended with Corners Against Over X.
over25CornersAgainstPercentage_overall - over85CornersAgainstPercentage_overall / home / away
Percentage of matches this season that ended with Over X corners against
over05Cards_overall - over85Cards_overall / home / away
Number of times matches ended with Over X total cards (both teams).
over05CardsPercentage_overall - over85CardsPercentage_overall / home / away
Percentage of matches that ended with Over X total cards (both teams)
over05CardsFor_overall - over65CardsFor_overall / home /away
Number of times matches ended with Over X cards for the team themselves
over05CardsForPercentage_overall - over65CardsForPercentage_overall / home / away
Percentage of matches that ended with Over X cards for the team
over05CardsAgainst_overall - over65CardsAgainst_overall / home / away
Number of times matches ended with Over X cards for the opposing team
over05CardsAgainstPercentage_overall - over65CardsAgainstPercentage_overall / home / away
Percentage of matches that ended with Over X cards for the opposing team
leaguePosition_overall / home / away
League position and home / away table position
firstGoalScored_overall / home / away
Number of matches where this team scored the first goal
firstGoalScoredPercentage_overall / home /away
Percentage of matches where this team scored the first goal
cornersTotal_overall / home / away
Total number of Corners For this season
cardsTotal_overall / home / away
Total number of cards earned and against this season
cornersTotalAVG_overall / home /away
Average total corners for per match
cornersAVG_overall / home /away
Average Corners For per match
cornersAgainst_overall / home / away
Total number of corners conceded this season
cornersAgainstAVG_overall / home / away
Average corners against per match
cornersHighest_overall / home / away
Highest number of corners in a match
cornersLowest_overall / home /away
Lowest number of corners in a match
cardsHighest_overall / home /away
Highest number of cards in a match
cardsLowest_overall / home / away
Lowest number of cards in a match
cardsAVG_overall / home / away
Average number of cards per match. Both teams total
shotsTotal_overall / home / away
Number of total shots taken by this team this season
shotsAVG_overall / home /away
Average number of shots taken per match
shotsOnTargetTotal_overall / home / away
Number of shots on target this season
shotsOffTargetTotal_overall / home / away
Number of shots off target this season
shotsOnTargetAVG_overall / home / away
Average number of shots on target per match
shotsOffTargetAVG_overall / home / away
Average number of shots off target per match
possessionAVG_overall / home / away
Average possession per match
foulsAVG_overall / home / away
Average fouls per match. Total number of fouls for both teams
foulsTotal_overall / home / away
Number of total fouls this season. Both teams
offsidesTotal_overall / home / away
Number of offsides this season. Both teams
offsidesTeamTotal_overall /home /away
Number of offsides for this team. This season
offsidesRecorded_matches_overall / home / away
Number of matches where offsides were recorded.
offsidesAVG_overall / home /away
Average number of total offsides per match. Both teams
offsidesTeamAVG_overall / home /away
Average number of offsides for the team, per match.
offsidesOver05_overall - offsidesOver65_overall / home /away
Number of matches where it ended Offsides Over x
over05OffsidesPercentage_overall - over65OffsidesPercentage_overall / home / away
Percentage of matches that ended with Over X match offsides
offsidesTeamOver05_overall - offsidesTeamOver65_overall /home /away
Number of matches where it ended Offsides over X for the team in particular
over05OffsidesTeamPercentage_overall - over65OffsidesTeamPercentage_overall /home /away
Percentage of matches where it ended Offsides over X for the team in particular
scoredBothHalves_overall /home /away
Number of matches where this team scored in both halves
scoredBothHalvesPercentage_overall / home /away
Percentage of matches where this team scored in both halves
seasonMatchesPlayedGoalTimingRecorded_overall / home / away
Number of matches where goal timings were recorded
BTTS_and_win_overall / home /away (+ BTTS_and_draw, BTTS_and_lose)
Number of matches with BTTS and win/draw/lose.
BTTS_and_win_percentage_overall / home / away (+ BTTS_and_draw, BTTS_and_lose)
Percentage of matches with BTTS and win/draw/lose.
AVG_2hg_overall / home / away
Average 2nd half goals per match. Both teams
scored_2hg_avg_overall / home / away
Average goals scored per match in the 2nd half
conceded_2hg_avg_overall / home / away
Average goals conceded per match in the 2nd half
total_2hg_overall / home / away
Total 2nd half goals this season. Scored and conceded
conceded_2hg_overall / home / away
Total goals conceded in the 2nd half.
scored_2hg_overall / home /away
Total goals scored in the 2nd half
over05_2hg_num_overall - over25_2hg_num_overall / home /away
Number of matches that ended with Over X in the 2nd half.
over05_2hg_percentage_overall - over25_2hg_percentage_overall / home / away
Percentage of matches that ended with Over X in the 2nd half.
table_position
Current table position
performance_rank
How good this team's PPG is compared to other teams in the league
risk
Prediction risk
goals_scored_min_0_to_10 - goals_scored_min_81_to_90
Number of goals scored during this time period. This season
goals_conceded_min_0_to_10 - goals_conceded_min_81_to_90
Number of goals conceded during this time period. This season
​
Last modified 6mo ago
Copy link