statsbombpy 1.22.0

This release uses the endpoint-versions endpoint for API versioning so that statsbombpy is automatically in sync with the API. Previously, endpoint versions were hardcoded and required manually updating after each update to the API.

Additionally a bug causing an index misalignment error in the sb.frames() function has been fixed.

statsbombpy 1.21.0

This version adds a User-Agent header to API requests

statsbombpy 1.20.0

API version updates

Player Match Stats v6 → v7
Player Season Stats v5 → v6
Team Match Stats v2 → v3

statsbombpy 1.19.0

This release upgrades the API version number for the following endpoints:

player-match-stats -> v6
player-season-stats -> v5
events -> v10

statsbombpy 1.18.0

This release make the following fields available via the matches function:

competition_id competition_country_name competition_name season_id home_team_id home_team_gender home_team_youth home_team_group home_team_country_id home_team_country_name away_team_id away_team_gender away_team_youth away_team_group away_team_country_id away_team_country_name competition_stage_id stadium_id stadium_country_id stadium_country_name referee_id referee_country_id referee_country_name home_manager_id home_manager_name home_manager_nickname home_manager_dob home_manager_country_id home_manager_country_name away_manager_id away_manager_name away_manager_nickname away_manager_dob away_manager_country_id away_manager_country_name

statsbombpy 1.17.0

This release upgrades the API version number for the following endpoints:

team-match-stats -> v2
team-season-stats -> v3
events -> v9
lineups -> v5

What's new?

• Added HOPS player ratings to lineups
• Added set_piece_phase, duel_win_probability, HOPS ratings and attacking_direction to events
• Added metrics based on indirect free kick outcomes and average aerial duel difficulty to team match stats
• Added metrics based on indirect free kick outcomes to team season stats

Read more on our blog

statsbombpy 1.16.0

This release upgrades the API version number for the following endpoint:
player-match-stats -> v5

What's new?

The following fields have been added to player_match_stats:

• player_match_ccaa: Claims or CCAA%(Claimable Collection Attempts over Average), is a measure of how likely the
  goalkeeper is to attempt to claim a "claimable" pass, versus the average goalkeeper attempted claim rate
• player_match_claim_success: How many of a goalkeeper’s claim attempts are successful
• player_match_da_aggressive_distance: An average value of how far forward from the goal a goalkeeper is coming to
  perform defensive actions.
• player_match_goals_conceded: How many goals a goalkeeper conceded (doesn’t include penalties or own goals)
• player_match_gsaa: How many goals did the keeper save/concede versus expectation (post-shot xG faced)
• player_match_gk_positioning_error: How far on average a goalkeeper is from the optimal position for facing a shot
• player_match_positive_outcome_score: How frequently is the player involved in sequences that resolve with a positive outcome (shot, free kick in the attacking half or a corner) while on the pitch
• player_match_npot_psxg_faced: How much non-penalty on-target post-shot xG a goalkeeper faced
• player_match_save_ratio: Percentage of on-target shots that were saved by the goalkeeper
• player_match_gsaa_ratio: The measure of goals saved above average, as a percentage of shots faced by the
  goalkeeper
• player_match_npot_shots_faced: How many non-penalty on-target shots a goalkeeper faced

statsbombpy 1.15.0

Add missing events and formations fields to sb.lineups()

statsbombpy 1.14.0

This release adds functionality to interact with the new team match stats endpoint, which provides aggregated data at the team-match level. It is only available to customers with API access.

statsbombpy 1.13.1

This update fixes a bug with certain 360 frames where the variable distances_from_edge_of_visible_area is None. Previously, the sb.frames() function couldn't handle such instances and would return an error for that match.