The goal of fitzRoy is to make it easy to access data from the AFLM and AFLW competitions. It provides a simple and consistent API to access data such as match results, fixtures and player statistics from multiple data sources.
Primarily, fitzRoy
can be used to access data from
various sources using the fetch_
functions. For a detailed
view on how the API works - view the Main
Fetch Functions vignette.
There are 5 main data sources for data in fitzRoy. Where possible, we do not edit the data from how we receive it, although in some cases, we do need to aggregate and calculate certain fields based on the structure of the site.
You can choose your data source as an argument to any
fetch_
function using the source =
argument.
We provide data from the (AFL website)[https://www.afl.com.au/]
as the default to any fetch_
function. This data is from
the official AFL data provider. With this data, we can return data for
both the Mens and Womens competitions. The oldest data is from 2012. It
provides access to all data types including results, fixtures, ladders,
lineups and stats.
AFL Tables has historically been the main source of data in fitzRoy. It is the most complete source of data about AFL that exists (to our knowledge at least!). It contains data from 1897 and is the only data source included in fitzRoy with such historical data. The types of data it contains are results, ladders and stats.
Footywire has traditionally been the main source of player statistics in fitzRoy. It contains data dating back to 2012 and was generally used as a supplement to AFL Tables data. The types of data it returns are results, fixtures and statistics.
Squiggle is a famous AFL
Prediction and Analysis website run by Max Barry. In recent years,
Squiggle has become the main place to aggregate various predictive
models. Max has provided a nice and well documented API that fitzRoy uses to return
data. Helper functions included in the fetch_
family will
return results, fixtures and ladders but the
fetch_squiggle_data
function provides direct access to the
API. Read the Squiggle
API vignette for more details.
Twitter user Fryzigg has provided
access to some advanced player statistics. These are included in the
fetch_player_stats
function. Read the Fryzigg
API vignette for more information.
In most cases, trying to use the same source for all of your analysis will be most beneficial. This is not always possible as some sources only go back so far (the AFL website only has data back to 2011), while some data is not available (AFL Tables doesn’t have decent fixture data). If you are mixing sources, be careful to understand differences in naming structures, team names and player names.
It is also a good idea to avoid regularly fetching whole datasets. Where possible, try to keep an off-line version of your data and only request the smallest amount possible to get the new data you require. This is both faster (less data transferred over your Internet connection and less data living in your computer memory) but also helps to reduce traffic on the data providers servers.
Fixture data is available from multiple places. The most reliable and
complete data usually comes from the AFL website. From that website you
can specify either the Mens or Womens competitions using the
comp
argument.
fixture <- fetch_fixture(2021, comp = "AFLW")
fixture %>%
select(
utcStartTime, round.name,
home.team.name, away.team.name, venue.name
)
If wanted, you could return just a single round.
fetch_fixture(2021, round_number = 5, comp = "AFLM") %>%
select(
utcStartTime, round.name,
home.team.name, away.team.name, venue.name
)
You can get results data from other sources including
Squiggle
and Footywire
. The default source for
fetch_results()
is the AFL.com.au website.
You can get the lineup for a particular round. This is usually useful when running after the teams have been announced but before the match has been played.
The only data source with lineup data is the AFL.com.au website.
You can access AFL match results data from various sources. The most complete is the AFL Tables data, which includes all matches from 1897-current.
While it is possible to return all historical data, it is usually good practice to only return a small amount of data - such as a single season or round - and keep your own offline database of historical data.
You can get results data from other sources including
AFL
, Squiggle
and Footywire
. The
default source for fetch_results()
is the AFL.com.au
website.
results_afl <- fetch_results(2020, round_number = 11)
results_aflw <- fetch_results(2020, comp = "AFLW")
results_squiggle <- fetch_results_squiggle(2019, round_number = 1)
results_footywire <- fetch_results_footywire(1990)
You can get AFLW results by using the comp
argument.
The ladder for a particular round can be returned using
fetch_ladder
. Usually this only makes sense to return for
one round at a time, although it is possible to return multiple
rounds.
ladder <- fetch_ladder(2020, round_number = 7, comp = "AFLW") %>%
select(
season, round_name, position,
team.name, pointsFor, pointsAgainst, form
)
ladder
There are many variables included in the AFL.com.au ladder.
You can get ladder data from other sources including
Squiggle
and Afltables
. The default source for
fetch_ladder()
is the AFL.com.au website.
We can return player statistics for a set of matches. The exact stats that are included varies quite a bit between data sources.
The default is again the AFL.com.au which is fairly comprehensive.
We also have detailed player stats courtesy of Fryzigg.
Other providers include Afltables and Footywire.
You can view how to return data from two providers using their API’s at the respective Vignettes.