understatapi.endpoints.player module

Player endpoint

class understatapi.endpoints.player.PlayerEndpoint(player, session)

Bases: BaseEndpoint

Use this class to get data from a url of the form https://understat.com/player/<player_id>

Example

>>> session = requests.Session()
>>> player_ids = ["000", "111"]
>>> for player in PlayerEndpoint(player_ids, session=session):
...     print(player.player)
000
111

parser: BaseParser = <understatapi.parsers.player.PlayerParser object>

__init__(player, session)

Parameters

• player (Union[List[str], str]) – Id of the player(s) to get data for

• session (Session) – The current session

property player: Union[List[str], str]

player id

Return type

Union[List[str], str]

_get_data(**kwargs)

Get data on a per-player basis via AJAX endpoint.

Parameters

kwargs (Any) – Keyword argument to pass to understatapi.endpoints.base.BaseEndpoint._request_ajax()

Return type

Dict[str, Any]

Returns

Dictionary with keys: player, matches, shots, groups, etc.

get_match_data(**kwargs)

Get match level data for a player

Parameters

kwargs (Any) – Keyword argument to pass to understatapi.endpoints.base.BaseEndpoint._request_ajax()

Return type

List[Dict[str, Any]]

get_shot_data(**kwargs)

Get shot level data for a player

Parameters

kwargs (Any) – Keyword argument to pass to understatapi.endpoints.base.BaseEndpoint._request_ajax()

Return type

List[Dict[str, Any]]

get_season_data(**kwargs)

Get season level data for a player

Parameters

kwargs (Any) – Keyword argument to pass to understatapi.endpoints.base.BaseEndpoint._request_ajax()

Return type

List[Dict[str, Any]]