Docs
Coverage MatrixDocumentationRelease LogLog In

Introduction

The Australian Rules Football API provides real-time match updates and a database of supplementary statistics. Data is collected via Sportradar on-venue scouts and in-house operators.

We cover both Men’s and Women’s AFL. Select the Aussie Rules package in our Coverage Matrix for a breakdown of data offered for each league.

The API is consistent in structure, format, and behavior with the other General Sport APIs. Primary feeds will return seasons, competitions, team and player data, and real-time scores.

Additional feeds provide a host of complementary stats, including:

  • Standings
  • Team profiles
  • Player biographical information
  • Match win probabilities
  • Match clock for all key events in real time (when available)
  • Historical results for two previous seasons

Real-time customers are also offered two delivery Push Feeds to enhance speed.

🗝️

Authentication is required for all API calls

API Map

To best utilize the Aussie Rules Football API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

The primary feeds require only a date or human-readable parameters to call the endpoints. Those feeds provide Sport Event Ids, Competitor Ids, or Season Ids which can be used to generate the match, team, and tournament feeds.


Endpoint Descriptions

Competition Info - Provides the name, id, and gender for a given competition.

Competition Seasons - Provides historical season information for a given competition. Competitions will return a maximum of three seasons of data, including current or newly created seasons.

Competitions - Provides a list of all available competitions in the API.

Competitor Merge Mappings - Provides the valid Sportradar Id in cases when two competitors have been merged into one. Mapping entries will remain in the feed for 7 days.

Competitor Profile - Provides top-level information for a given team, including the full team roster, manager, and home venue.

Competitor Summaries - Provides previous and upcoming match information for a given competitor, including statistics for past matches and scheduling info for upcoming matches. 

Competitor vs Competitor - Provides previous and upcoming matches between two teams including scoring information and team match statistics. 

Daily Summaries - Provides match information for a given day including team scoring and team match statistics.

Live Summaries - Provides match information for all currently live matches including scoring and team match statistics. This feed updates in real time as matches are played.

Live Timelines - Provides a play-by-play event timeline for currently live matches. 

Live Timelines Delta - Provides a 10 second live delta of match information, including scoring and a play-by-play event timeline. 

Player Merge Mappings - Provides valid ids for players who have had their profiles merged. While Sportradar always strives to provide one unique player id, it is a possibility for two ids to be created. This feed provides the correct id once profiles have been merged.

Player Profile - Provides player biographical information, including team membership info.

Season Competitors - Provides a list of teams participating for a given season. 

Season Info - Provides detailed information for a given season, including participating teams and coverage level. 

Season Lineups - Provides match lineups for a given season.

Season Links - Provides information about linked cup rounds for a given season. Use this feed to compile full advancement brackets for relevant seasons/tournaments. Links between all matches and rounds are available when competitors (TBD vs. TBD) are not yet known.

Season Probabilities - Provides 2-way win probabilities (home team win, away team win) for all matches for a given season.  

Season Standings - Provides detailed standings info for a given season.

Season Summaries - Provides information for all matches from a given season including scoring and statistics at the match level. 

Seasons - Provides a list of historical season information for all competitions. Competitions will return a maximum of three seasons of data, including current or newly created seasons.

Sport Event Lineups - Provides detailed roster information for a given match.

Sport Event Summary - Provides real-time scoring and match-level statistics for a given match. Please note that data returned is determined by coverage level.

Sport Event Timeline - Provides real-time match-level statistics and a play-by-play event timeline for a given match. Please note that data returned is determined by coverage level.

Sport Events Created - Provides ids for sport events that have been created in the last 24 hours.

Sport Event Removed - Provides ids for sport events that have been removed or deleted.

Sport Event Updated - Provides ids for sport events that have been updated in the last 24 hours.

Push Events - Provides real-time event updates for all live matches.

Push Statistics - Provides real-time team and player match-level statistics for all live matches.


Data Retrieval Sample

To find the probability of a home team win for a given game:

  1. Call the Daily Schedule for the day the sport event takes place and find the Season Id for the chosen sport event
  2. Make note of the Sport Event Id for the given sport event
  3. Call the Season Probabilities using the Season Id
  4. Find Sport Event Id within the results locate the home team and the outcome probability

The probability of a home team win is displayed.


Integration Links

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Aussie Rules Football API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Aussie Rules Football API XSD schema.

Aussie Rules Football v3 Schema