8000+ players, 250+ teams, 6000+ games over the 2022, 2023, 2024 & 2025 seasons - rugbypy is a Python package that aims to make rugby data more available to aid in the development of rugby analytics. Documentation can be found here

If you would like to help keep the lights on and support this repo feel free to buy me a coffee!

python version 3.11

pip install rugbypy

You can fetch all matches that have ever occurred with:

from rugbypy.match import *
matches = fetch_all_matches()
matches

Fetching all matches...

You can fetch all the matches that occured on a particular date with:

from rugbypy.match import *
matches = fetch_matches_by_date(date="20251205")
matches

Fetching matches on date: 20251205...

The old method below is deprecated as of v3:

matches = fetch_matches(date="20230101")

Deprecated, please use the fetch_matches_by_date() function instead

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="35e0b16d")
match_details

Fetching match details for match_id: 35e0b16d...

You can fetch all the teams within the rugbypy database from our registry with:

fetch_all_teams()

Fetching all teams available...

You can fetch the team stats for a particular with:

from rugbypy.team import *
team_stats = fetch_team_stats(team_id="93542906")
team_stats

Fetching all team stats for team_id: 93542906...

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="93542906", date="20251213")
team_stats

Fetching team stats for team_id: 93542906 on date: 20251213...

We have the ability to fetch player stats for all the games they have been involved in. We firstly identify the player_id of a player by searching our player registry.

from rugbypy.player import *
players = fetch_all_players()
players

Or we can search for a certain player through our similarity tool:

from rugbypy.player import *
individual_player = fetch_player_id("jac morgan")
individual_player

Once we have their player_id we can fetch their player stats using fetch_player_stats. In this example we fetch Jac Morgan player stats:

from rugbypy.player import *
player_stats = fetch_player_stats(player_id="24717f78")
player_stats

Fetching all player stats for player_id: 24717f78...

We can also fetch the player stats on a particular date using fetch_player_stats. In this example we fetch Jac Morgans player stats on 2025-01-01:

from rugbypy.player import *
player_stats = fetch_player_stats(player_id="24717f78", date="20250101")
player_stats

Fetching player stats for player_id: 24717f78 on date: 20250101...

You can fetch all competition ids to from our competition registry with:

from rugbypy.competition import *
competitions = fetch_all_competitions()
competitions

Fetching all competition...

You can fetch all venue ids to from our venue registry with:

from rugbypy.venue import *
competitions = fetch_all_venues()
competitions

Fetching all venues...