understat

understat.UnderstatPlayer

get_player_match_data

UnderstatPlayer.get_player_match_data(**filter)

get xG data for the player.

Parameters

**filter (dict) – a dictionary of possible filters.

Returns

match data of the player

Return type

list

get_player_grouped_data_by_type

UnderstatPlayer.get_player_grouped_data_by_type(type='season', **filter)

get the per season data for the player.

Parameters
  • type (str) – the type of data to be fetched.

  • **filter (dict) – a dictionary of possible filters.

Returns

match data of the player

Return type

list

get_player_shot_data

UnderstatPlayer.get_player_shot_data(**filter)

get the shot data for the player.

Parameters

**filter (dict) – a dictionary of possible filters.

Returns

shot data of the player

Return type

list

get_player_min_max_data

UnderstatPlayer.get_player_min_max_data(**filter)

get the min, max and average data for the player.

Parameters

**filter (dict) – a dictionary of possible filters.

Returns

min max data of the player

Return type

list

get_player_positions

UnderstatPlayer.get_player_positions(**filter)

get the possble player locations

Returns

list of positions of the player

Return type

list

get_player_list_by_league

static UnderstatPlayer.get_player_list_by_league(league, season, detail_level='detailed')

get all possible players in a league.

Parameters
  • league (str) –

    the league for which the data is to be fetched. multiple values can be passed seperated by a ‘,’ . Possible values:

    • EPL

    • La_Liga

    • Bundesliga

    • Serie_A

    • Ligue_1

    • RFPL

  • season – season for which data is needed. For 2020/21 season, enter 2020.

Returns

players in the league listed.

Return type

dict

understat.UnderstatTeam

get_team_league_history

UnderstatTeam.get_team_league_history(season, **filter)

get the league history for a given team

Parameters

season (str) – season for which history is needed. For 2020/2021 season, input 2020.

Returns

dictionary containing the data for matches played in given season

Return type

dict

get_team_player_summary

UnderstatTeam.get_team_player_summary(season, **filter)

get the summary statistics for each player of the team for a given season.

Parameters

season (str) – season for which history is needed. For 2020/2021 season, input 2020.

Returns

list containing summary statistics of players

Return type

list

get_team_fixtures

UnderstatTeam.get_team_fixtures(season, **filter)

get the team fixtures for given season. for the fixtures that have been played, basic stats are included.

Parameters

season (str) – season for which fixtures are needed. For 2020/2021 season, input 2020.

Returns

list containing fixtures

Return type

list

get_team_grouped_date_by_type

UnderstatTeam.get_team_grouped_date_by_type(season, type='situation', **filter)

get the per season data for the team.

Parameters
  • season (str) – season for which fixtures are needed. For 2020/2021 season, input 2020.

  • type (str) –

    the type of data to be fetched. This can be one of the following:

    • situation

    • formation

    • gameState

    • timing

    • shotZone

    • attackSpeed

Returns

dictionary containing fixtures

Return type

dict

understat.UnderstatMatch

get_match_shot_data

UnderstatMatch.get_match_shot_data()

get the shot data for the match.

Returns

list containing shot data for the match.

Return type

list

get_match_stats

UnderstatMatch.get_match_stats()

get the general match statistics for both teams.

Returns

a dictionary containing match statistics.

Return type

dict

get_match_roster

UnderstatMatch.get_match_roster()

get the match roster for both teams.

Returns

a dictionary containing match roster for both teams.

Return type

dict