League Teams

get
Get Teams in a League Season
https://api.footystats.org/league-teams?key=YOURKEY&league_id=*
Returns the stats and basic data of each team as a JSON array.
Request
Response
Query Parameters
max_time
optional
number
UNIX Timestamp. Set this number if you would like the API to return the stats of the league and the teams up to a certain time. For example, if I enter &max_time=1537984169, then the API will respond with stats as of September 26th, 2018.
league_id
required
number
League season ID 
key
required
string
Your API Key
200: OK
Cake successfully retrieved.
{
    success: true,
    data: [
        {
            id: "59",
            original_id: 59,
            name: "Arsenal FC",
            cleanName: "Arsenal",
            alt_name1: "",
            alt_name2: "",
            alt_name3: "",
            english_name: "Arsenal FC",
            shortHand: "arsenal-fc",
            country: "England",
            continent: "eu",
            image: "https://footystats.org/teams/england-arsenal-fc.png",
            flag_element: "<span class='mr05 flag flag-gb-eng'></span>",
            season: "2018/2019",
            seasonClean: "2018/19",
            url: "https://footystats.org/clubs/england/arsenal-fc",
            seasonURL_overall: "https://footystats.org/clubs/england/arsenal-fc",
            seasonURL_home: "https://footystats.org/clubs/england/arsenal-fc",
            seasonURL_away: "https://footystats.org/clubs/england/arsenal-fc",
            stadium_name: "Emirates Stadium (London)",
            stadium_address: "Queensland Road, London",
            previous_seasons: [ ],
            suspended_matches: 0,
            homeAttackAdvantage: -13,
            homeDefenceAdvantage: 42,
            homeOverallAdvantage: 15,
            formRun_overall: null,
            formRun_home: null,
            formRun_away: null,
            seasonGoals_overall: 14,
            seasonGoals_home: [
            "30",
            "70",
            "90+2",
            "56",
            "59",
            "81",
            "83"
            ],
            seasonGoals_away: [
            "37",
            "41",
            "11",
            "62",
            "81",
            "49",
            "58"
            ],
            seasonConceded_overall: 9,
            seasonConceded_home: [
            "14",
            "64",
            "25"
            ],
            seasonConceded_away: [
            "9",
            "20",
            "81",
            "45+2",
            "70",
            "90+1"
            ],
            seasonGoalsTotal_overall: 23,
            seasonGoalsTotal_home: 10,
            seasonGoalsTotal_away: 13,
            seasonScoredNum_overall: 14,
            seasonScoredNum_home: 7,
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
​

Endpoints - Previous

League Stats

Next - Endpoints

League Matches

Last updated 6 months ago

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

League Teams

getGet Teams in a League Season

get
Get Teams in a League Season