CRAN release: 2022-11-07
CRAN release: 2022-02-08
Introducing itscalledsoccer ⚽ 🎉
This is the first release of
itscalledsoccer, a wrapper around the same API that powers the American Soccer Analysis app. It enables R users to programmatically retrieve advanced analytics for their favorite players and teams, with coverage of the following competitions:
- Major League Soccer
- National Women’s Soccer League
- USL Championship
- USL League One
- MLS NEXT Pro
- North American Soccer League (defunct)
We at ASA, have been working on this for the better part of 6 months and are super excited to release it. We hope it makes interacting with our data easier and allows people to build new and informative things.
What’s new ✨
Technically everything in the package is new, but we’ll highlight all the functions that are currently available and provide a brief description of what data they return. The package does take a couple seconds to initialize because we do cache some data at the start.
get_stadia: Gets data about stadiums, things like location, name and capacity.
get_referees: Gets data about referees, things like name, birth date and nationality.
get_managers: Gets data about managers, things like name and nationality.
get_teams: Gets data about teams, things like abbreviation and name.
get_players: Gets data about players, things like height, weight and nationality.
get_games: Gets data about games, things like score, attendance and matchday.
get_player_xgoals: Gets a player(s) xGoals for a season or range of dates.
get_player_xpass: Gets a player(s) xPass for a season or range of dates.
get_player_goals_added: Gets a player(s) g+ for a season or range of dates.
get_player_salaries: Gets a player(s) salary for a season or range of dates, only available for MLS.
get_goalkeeper_xgoals: Gets a goalkeepers(s) xGoals for a season or range of dates.
get_goalkeeper_goals_added: Gets a goalkeepers(s) g+ for a season or range of dates.
get_team_xgoals: Gets a team(s) xGoals for a season or range of dates.
get_team_xpass: Gets a team(s) xPass for a season or range of dates.
get_team_goals_added: Gets a team(s) xPass for a season or range of dates.
get_team_salaries: Gets a team(s) salary for a season or range of dates, only available for MLS.
get_game_xgoals: Gets a game(s) xGoals for a season or range of dates.
For more info on xGoals, xPass and g+, check out these articles:
Bug fixes 🐛
None, but if you do find a bug while using the package, please submit an issue.
We know our documentation is a bit sparse at the moment, but we plan on building it up and adding more examples over time. In the meantime, the API documentation should be a sufficient stop gap for specific functions.