2 posts tagged with "roundup"

It's been a busy year for us on the AFL API and if you haven't been following on mid-season, here's a round up of what's been added from post-season 2024 to right now.

New API Features​

Tier 2 Competitions​

We have added the Tier 2 competitions listed in the table below to the AFL API. Tier 2 marks the use of multiple League Levels for the first time, so note that some competitions require you to use a Level Id other than 1.

All match endpoints are available to Tier 2 matches, though due to each competition's smaller data set, they return less information compared to AFL or AFLW matches. Starting with 2026, we will be providing the Tier 2 Advanced data set to selected competitions.

More information about the Tier 2 Advanced Data Set can be found here.

Competition	League	Id	Level	Id	Advanced Data Set?
VFL	Victorian Football League	5	Seniors	1	Yes - 2026
VFLW	Victorian Football League Womens	6	Seniors	1
U18 Champs	Under 18 Championship	8	Under-18	5	Yes - 2024*
U18 Champs AFLW	AFLW Under 18 Championship	9	Under-18	5	Yes - 2024*
U16 Champs	Under 16 Championship	18	Under-16	3
U16 Champs AFLW	AFLW Under 16 Championship	19	Under-16	3
Coates Talent League Boys	Coates Talent League Boys	10	Under-18	5	Yes - 2026
Coates Talent League Girls	Coates Talent League Girls	11	Under-18	5
AIS Academy	AFL AIS Academy	14	Under-18	5
SANFL	South Australian National Football League	12	Seniors	1	Yes - 2026
SANFL Reserves	South Australian National Football League	12	Reserves	2	Yes - 2026
SANFL U16	South Australian National Football League	12	Under-16	3
SANFL U18	South Australian National Football League	12	Under-18	5	Yes - 2026
SANFLW	South Australian National Football League Womens	13	Seniors	1
WAFL	West Australian Football League	16	Seniors	1	Yes - 2026
WAFL Reserves	West Australian Football League	16	Reserves	2	Yes - 2026
WAFL Colts	West Australian Football League	16	Under-19	6	Yes - 2026
WAFLW	West Australian Football Womens	17	Seniors	1
Interstate Matches	State League Representative Matches	20	Seniors	1

*U18 Championship matches are already presented with the Advanced data set so it is available from 2024.

Match Statistics Flow Endpoint​

We added a new stats flow endpoint in August which returns all the timecoded occurrences of metric values in a match. Helpful if you want to track when we recorded Long Down the Line kicks happening, which is not easy to determine from match transactions alone.

• More info

Match Stoppages Endpoint​

Back in November 2024 we added the stoppages endpoint, which returns all the timecoded occurrences of each stoppage in a match, along with a wealth of detail, including details on the stoppage exit.

• More info

Centre Bounce Zone​

At the very end of 2024 we introduced the Centre Bounce zone to the API, providing the ability to filter match stats to those that happened at centre bounces, and adding this zone to all applicable endpoints.

• More info

Indigenous All Stars Match​

We provided the 2025 Toyota AFL Indigenous All Stars Match live from the AFL API last February. Should these matches occur again in future the API is ready to support them.

Endpoint Enhancements​

We improved a bunch of existing endpoints throughout the last year too - here's the highlights.

Endpoint	Improvement	When
League Levels	Tier Classification	v1.58 - Jul 2025
Match	Last Statistic Update timestamp	v1.46 - Oct 2024
Match	Win/Loss/Draw result	v1.53 - Apr 2025
Match Shots	Behind Shot Result	v1.54 - May 2025
Match Shots	Shot Pressure	v1.62 - Oct 2025
Match Statistics Leaders	Groundball Get Leaders	v1.54 - May 2025
Match Statistics Leaders	Stoppage-related Leaders	v1.60 - Aug 2025
Match Statistics Leaders	Filter by Period and Top X Leaders	v1.61 - Sep 2025
Match Stoppages	Physical Zone	v1.51 - Mar 2025
Match Venue	Interstate Travel	v1.52 - Apr 2025
Season Fixture	Round Number Filter	v1.55 - Jun 2025

New Metrics​

We've added dozens of new metrics to the API this year - too many to list in detail here, so here's the links to details in each release they were added.

Metric	When
First Possession from Stoppage Outcome	v1.60 - Aug 2025 v1.61 - Sep 2025 v1.62 - Oct 2025
Forward Kick Percentage	v1.46 - Oct 2024
Inside 50 Target Chance Percentage	v1.48 - Dec 2024
Intercept Chain Source & Outcome	v1.55 - Jun 2025 v1.56 - Jun 2025 v1.57 - Jul 2025 v1.58 - Jul 2025 v1.60 - Aug 2025 v1.62 - Oct 2025
Kick-In Launch Locations	v1.48 - Dec 2024
Kick Set/Non-Set Pressure	v1.46 - Oct 2024
Player Rating Percentage	v1.51 - Mar 2025
Pre-Clearance Contested Possession Situation	v1.58 - Jul 2025
Post-Clearance Contested Possession Type	v1.59 - Jul 2025
Points Above Expected Set/Non-Set Pressure	v1.61 - Sep 2025
Points from Shot Type	v1.55 - Jun 2025
Score Involvement Percentage	v1.47 - Nov 2024
Shot At Goal Expected Goal & Points	v1.60 - Aug 2025
Shot At Goal Type	v1.54 - May 2025 v1.56 - Jun 2025
Squad Pressure Act Type Percentage	v1.57 - Jul 2025

With the AFL Premiership season done, and AFLW 2024 approaching the finish line, we thought it would be a good point to summarise everything added to the AFL API this year.

New API Features​

Match Statistic POST endpoints​

At the start of the year, we introduced the Match Statistics POST Endpoints. While they perform the same function as the GET Endpoints, they enable you to make multiple statistic queries against a match in one API call, rather than several. They are both faster and more efficient, plus they save on API calls when you're watching your usage limit.

• Players statistic POST endpoint
• Squads statistic POST endpoint

AFLW Matches​

AFLW is now formally supported by the AFL API, providing both past, live and future matches as they happen. AFLW matches work near identically to their Premiership counterparts, so you can reuse existing reports, dashboards and applications for AFLW simply by querying their match ids.

• How AFLW Works

'Last X' match statistics filter​

The match statistics endpoints can now be filtered to a time range within a period, or to the last few minutes of play in a period. This can be used to drive a match day dashboard that shows how players are doing for the past 10 minutes.

• How Last X Works
• R Package Last X Functionality

Match Transaction & Summary File Support Package Functions​

The R Package (and later this year, the Python Package) now provides functions to generate these support site files from the AFL API.

• Support Site File Replacement Functions

New Metrics​

The following metrics were added to the AFL API between March and October this year.

• ABSENCE_CENTRE_BOUNCE_LOSS_PCT

  The percentage of a players total centre bounce absences that result in a clearance to the opposition squad.

• ABSENCE_CENTRE_BOUNCE_NEUTRAL_PCT

  The percentage of a players total centre bounce absences that do not result in a clearance for that centre bounce for either team.

• ABSENCE_CENTRE_BOUNCE_WIN_PCT

  The percentage of a players total centre bounce absences that result in a clearance to the given players squad.

• ATTENDANCE_CENTRE_BOUNCE_LOSS_PCT

  The percentage of a players total centre bounce attendances that result in a clearance to the opposition squad.

• ATTENDANCE_CENTRE_BOUNCE_NEUTRAL_PCT

  The percentage of a players total centre bounce attendances that do not result in a clearance for that centre bounce for either team.

• ATTENDANCE_CENTRE_BOUNCE_WIN_PCT

  The percentage of a players total centre bounce attendances that result in a clearance to the given players squad.

• CLEARANCE_PCT

  The percentage of all stoppages that resulted in a clearance win.

• DISPOSAL_PER_TURNOVER

  Ratio of Disposals compared to Disposals that were also turnovers.

• DISPOSAL_TURNOVER

  Disposals that resulted in a turnover, where the zone is attributed to the zone of the disposal.

• GOAL_EXPECTED

  Total goals expected from a given shot (based on location, pressure, sidedness). At a transaction level this will show expected accuracy and when summed will show the expected goal.

• HANDBALL_TURNOVER

  Handballs that resulted in a turnover, where the zone is attributed to the zone of the handball.

• INSIDE_50_FORCED_ENTRY_RETURN

  Total points returned after a forced inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_INITIAL_DIRECT_ENTRY_RETURN

  Total points returned after a direct initial inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_INITIAL_ENTRY_RETURN

  Total points returned after an initial inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_MID_STOPPAGE_DIRECT_ENTRY_RETURN

  Total points returned after a direct midfield stoppage inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_MID_STOPPAGE_ENTRY_RETURN

  Total points returned after a midfield stoppage inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_REPEAT_DIRECT_ENTRY_RETURN

  Total points returned after a direct repeat inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_REPEAT_ENTRY_RETURN

  Total points returned after a repeat inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_TRANSITION_DIRECT_ENTRY_RETURN

  Total points returned after a direct transition inside 50 entry and before another inside 50 or centre bounce.

• INSIDE_50_TRANSITION_ENTRY_RETURN

  Total points returned after a transition inside 50 entry and before another inside 50 or centre bounce.

• KICK_TURNOVER

  Kicks that resulted in a turnover, where the zone is attributed to the zone of the kick.

• METRES_GAINED_ASSISTED

  Total metres gained by a teammate that receives an uncontested possession from your disposal.

• METRES_GAINED_DISPOSAL

  Metres Gained via disposals. Measured from the point the original point of possession to the next possession or stoppage.

• METRES_GAINED_DISPOSAL_AVG

  The average number of meters gained per-disposal

• METRES_GAINED_HANDBALL

  Metres Gained via handballs. Measured from the point the original point of possession to the next possession or stoppage.

• METRES_GAINED_HANDBALL_AVG

  The average number of meters gained via handballs

• METRES_GAINED_KICK

  Metres Gained via kicks, measured from the point of the original possession to the next possession or stoppage.

• METRES_GAINED_KICK_AVG

  The average number of metres gained via kicks

• METRES_GAINED_NET

  Metres Gained plus Assisted Metres Gained.

• METRES_GAINED_OTHER

  Metres Gained not via disposals.

• METRES_GAINED_RETAIN

  Metres Gained where the disposal/possession was retained.

• ONE_PERCENTER

  Cumulation of knock ons, shepherds, credits, spoils and smothers.

• POINTS_ABOVE_EXPECTED

  Total points scored above the expected score.

• POSSESSION_CONTESTED_PCT

  The percentage of all possessions that are contested possessions.

• POSSESSION_UNCONTESTED_PCT

  The percentage of all possessions that are uncontested possessions.

• PRESSURE_ACT_FORCED_TURNOVER_BEHI_PCT

  The percentage of all forced turnovers that result in a behind.

• PRESSURE_ACT_FORCED_TURNOVER_GOAL_PCT

  The percentage of all forced turnovers that result in a goal.

• PRESSURE_ACT_FORCED_TURNOVER_POINTS

  Total points generated by pressure acts forcing a turnover.

• PRESSURE_ACT_FORCED_TURNOVER_SCORE_PCT

  The percentage of all forced turnovers that result in a score.

• RANKING_POINTS

  The Official Champion Data AFL Rankings system was established in 1999 and has been developed into a robust and comprehensive system for objectively measuring player performance through the use of statistical measures. The rankings are geared to reward the winning factors of a game of AFL football. They are used as the scoring measure in the Herald-Sun SuperCoach fantasy game.

• TIME_IN_POSSESSION_DISPUTE_PCT

  The percentage of total elapsed time where the ball was in play but neither team had possession.

• TIME_ON_GROUND_LOOSE

  Time in seconds that a player was loose during a game.

• TIME_ON_GROUND_LOOSE_PCT

  Percentage of time that a player was loose during a game.