rugbypy is a Python package that aims to make rugby data more available to aid in the development of rugby analytics.
Data is updated daily 5AM UTC! Currently we only have 2023 data available with previous years coming soon.
python version 3.8
pip install rugbypyYou can fetch all the matches that occured on a particular date with:
from rugbypy.match import *
matches = fetch_matches(date="20230101")
matchesFetching matches on date:20230101...
| match_id | competition_id | home_team_id | home_team | away_team_id | away_team | date | |
|---|---|---|---|---|---|---|---|
| 0 | 595735 | 267979 | 25907 | Northampton Saints | 25901 | Harlequins | 20230101 |
Then using that match id you can feed it into the match details function:
from rugbypy.match import *
match_details = fetch_match_details(match_id="595735")
match_detailsFetching match details for match_id:595735...
| match_id | date | season | competition_id | competition | venue_id | venue | city_played | home_team | away_team | home_team_id | away_team_id | completed | is_tournament | played_on_grass | attendance | home_team_form | away_team_form | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | 595735 | 20230101 | 2023 | 267979 | Premiership Rugby | 26070 | cinch Stadium at Franklin's Gardens | Northampton | Northampton Saints | Harlequins | 25907 | 25901 | True | True | True | None | LLWWL | WLWLL |
You can then fetch the team stats for a particular team on a particular date with:
from rugbypy.team import *
team_stats = fetch_team_stats(team_id="25901", date="20230108")
team_statsFetching team stats for team_id:25901 on date:20230108...
| team | game_date | team_id | team_vs | team_vs_id | match_id | players | clean_breaks | conversion_goals | defenders_beaten | ... | scrums_total | scrums_won | tackles | territory | total_free_kicks_conceded | total_lineouts | tries | turnover_knock_on | turnovers_conceded | yellow_cards | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | Harlequins | 20230108 | 25901 | Sale Sharks | 25908 | 595741 | [158708, 299436, 299031, 298485, 295117, 29477... | 3.0 | 0.0 | 24.0 | ... | 7.0 | 5.0 | 125.0 | 0.41 | 0.0 | 11.0 | 2.0 | 8.0 | 17.0 | 0.0 |
1 rows × 42 columns
We have the ability to fetch player stats for all the games they have bene involved in. We firstly identify the `player_id`` of a player by searching our player manifest file.
from rugbypy.player import *
player_manifest = fetch_all_players()
player_manifest.head()| player_id | player_name | |
|---|---|---|
| 0 | 246815 | Will Edwards |
| 1 | 158708 | Tommaso Allan |
| 2 | 299436 | Oscar Beard |
| 3 | 299031 | Fin Baxter |
| 4 | 298485 | Jordan Els |
Or we can search for a certain player through our similarity tool:
from rugbypy.player import *
individual_player = fetch_player(name="johnny sexton")
individual_player| player_id | player_name | |
|---|---|---|
| 267 | 149315 | Anthony Watson |
| 294 | 16004 | Johnny Sexton |
| 796 | 291349 | Ayden Johnstone |
We can also fetch the player stats for any player using their
player_ids. In this example we fetch Johnny Sextons player stats:
from rugbypy.player import *
player_stats = fetch_player_stats(player_id="16004")
player_statsFetching all player stats for player_id:16004...
| player_id | game_date | name | team | team_id | competition_id | competition | match_id | team_vs | team_vs_id | ... | rucks_won | runs | tackles | total_free_kicks_conceded | total_lineouts | tries | try_assists | turnover_knock_on | turnovers_conceded | yellow_cards | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | 16004 | 20230204 | Johnny Sexton | Ireland | 3 | 180659 | Six Nations Championship | 596205 | Wales | 4 | ... | 3.0 | 8.0 | 7.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 1.0 | 0.0 |
| 0 | 16004 | 20230211 | Johnny Sexton | Ireland | 3 | 180659 | Six Nations Championship | 596208 | France | 9 | ... | 1.0 | 5.0 | 3.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 |
| 0 | 16004 | 20230312 | Johnny Sexton | Ireland | 3 | 180659 | Six Nations Championship | 596216 | Scotland | 2 | ... | 2.0 | 5.0 | 9.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 2.0 | 0.0 |
| 0 | 16004 | 20230318 | Johnny Sexton | Ireland | 3 | 180659 | Six Nations Championship | 596219 | England | 1 | ... | 6.0 | 9.0 | 5.0 | 0.0 | 0.0 | 0.0 | 0.0 | 1.0 | 2.0 | 0.0 |
| 0 | 16004 | 20230909 | Johnny Sexton | Ireland | 3 | 164205 | Rugby World Cup | 596156 | Romania | 12 | ... | 0.0 | 5.0 | 4.0 | 0.0 | 0.0 | 2.0 | 0.0 | 0.0 | 0.0 | 0.0 |
| 0 | 16004 | 20230916 | Johnny Sexton | Ireland | 3 | 164205 | Rugby World Cup | 596166 | Tonga | 16 | ... | 1.0 | 1.0 | 2.0 | 0.0 | 0.0 | 1.0 | 0.0 | 0.0 | 0.0 | 0.0 |
| 0 | 16004 | 20230923 | Johnny Sexton | Ireland | 3 | 164205 | Rugby World Cup | 596175 | South Africa | 5 | ... | 1.0 | 3.0 | 11.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 |
7 rows × 41 columns
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent