Push Statistics

Syntax

https://api.sportradar.com/australianrules/{access_level}/{version}/stream/statistics/subscribe?api_key={your_api_key}

Replace placeholders with the following query parameters:

Parameter	Description
`access_level`	Defines the access level of your API key as Production (production) or Trial (trial).
`version`	Version number of the API you are accessing (v3).
`your_api_key`	Your API key.

Optional Query String Parameters

In addition to the URL parameters listed above, you can filter the Statistics information with one or more of the following optional query string parameters.

📘
Optional query string parameters must be added after your API key with an ampersand (&). If you are filtering for more than one result, separate the results with a comma (,) and no spaces.

Replace placeholders with the following query parameters:

URL Parameters	Description
`channel`	Channel type expressed as: {channel_type}. Example: channel=australianrules
`competition_id`	Competition Id expressed as: {competition_id}. Example: sr:competition:656
`event_id`	Event type expressed as: {event_type}. Example: event_id=score_change
`format`	Format type expressed as: {format}. Example: format=json
`season_id`	Season id expressed as: {season_id}. Example: season_id=sr:season:79676
`sport_event_id`	Sport event id expressed as: {sport_event_id}. Example: sport_event_id=sr:sport_event:16144572
`sport_id`	Sport id expressed as: {sport_id}. Example: sport_id=sr:sport:13

Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe?api_key={your_api_key}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

import requests
import json

r = requests.get("https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe",
    params = {'api_key': 'your_api_key'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L GET 'api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe?api_key={your_api_key}'

Samples with Query String Params

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe?api_key={your_api_key}&format=json&sport_event_id=sr:sport_event:16144572")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

import requests
import json

r = requests.get("https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe",
    params = {'api_key': 'your_api_key', 'format': 'json', 'sport_event_id': 'sr:sport_event:16144572'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L GET 'https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe?api_key={your_api_key}&format=json&sport_event_id=sr:sport_event:16144572'

Response Sample

The above commands return json like this.

Data Points

Metadata:

Attribute	Parent Element	Type	Description
`channel`	`metadata`	String	Sport of the stream connection ex. `aussierules`
`competition_id`	`metadata`	String	Unique Id of a competition ex. `sr:competition:656`
`event_id`	`metadata`	String	Type of timeline event `match_started`, `match_ended`, `score_change`, `period_score`, `period_start`, `break_start`
`format`	`metadata`	String	Format type of the response `json`, `xml`
`season_id`	`metadata`	String	Unique Id of a season ex. `sr:season:111244`
`sport_event_id`	`metadata`	String	Unique Id of a sport event ex. `sr:sport_event_id:49324739`
`sport_id`	`metadata`	String	Unique Id of a sport ex. `sr:sport:1`
`from`	`heartbeat`	Integer	Unix timestamp of the beginning of a heartbeat message ex. `1713804799`
`to`	`heartbeat`	Integer	Unix timestamp of the end of a heartbeat message ex. `1713804804`
`interval`	`heartbeat`	Integer	Interval of a heartbeat message in seconds
`type`	`heartbeat`	String	Type of heartbeat message ex. `events`, `statistics`
`package`	`heartbeat`	String	Package of a heartbeat message ex. `aussierules-v3`

Sport Event Status:

Attribute	Parent Element	Type	Description
`away_normaltime_score`	`sport_event_status`	Integer	Score for the away team in normal time
`away_score`	`sport_event_status`	Integer	Total score for the away team in the game
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time
`home_score`	`sport_event_status`	Integer	Total score for the home team in the game
`match_status`	`sport_event_status`	String	Status within a game (sport event). Provides more detail on the state of a sport event when live than `status` ex. `not_started`, `1st_quarter`, `ended`, `cancelled` See our FAQ for a complete list of statuses and their definitions.
`scount_abandoned`	`sport_event_status`	Boolean	Signifies a game was abandoned by a scout when `true`
`status`	`sport_event_status`	String	Status of a game ex. `not_started`, `2nd_half`, `ended`, `awaiting_penalties` See our FAQ for a complete list of statuses and their definitions.
`winner_id`	`sport_event_status`	String	Unique ID of the game winner ex. `sr:competitor:44`

Period Scores:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores`	Integer	Away team period score
`away_display_score`	`sport_event_status` - `period_scores`	String	Away team period display score ('Number of Goals'.'Number of Points'.'Total') ex. `5.5.35`
`home_score`	`sport_event_status` - `period_scores`	Integer	Home team period score
`home_display_score`	`sport_event_status` - `period_scores`	String	Home team period display score ('Number of Goals'.'Number of Points'.'Total') ex. `5.5.35`
`number`	`sport_event_status` - `period_scores`	Integer	Period number
`type`	`sport_event_status` - `period_scores`	String	Period type `regular_period`, `overtime`, `1st_period`, `2nd_period`, `3rd_period`, `4th_period`, `1st_pause`, `2nd_pause`, `3rd_pause`, `interrupted`

Player:

Attribute	Parent Element	Type	Description
`id`	`statistics` - `competitors` - `players`	String	Unique ID of a player ex. `sr:player:509236`
`name`	`statistics` - `competitors` - `players`	String	Name of a player ex. `Neale, Lachie`

Competitor:

Attribute	Parent Element	Type	Description
`abbreviation`	`statistics` - `competitors`	String	Abbreviation for a competitor name ex. `BRI` (Brisbane Lions)
`age_group`	`statistics` - `competitors`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`statistics` - `competitors`	String	Country of a competitor ex. `Australia`
`country_code`	`statistics` - `competitors`	String	Country code of a competitor ex. `AUS` (Australia)
`gender`	`statistics` - `competitors`	String	Gender for a competitor `male`, `female`
`id`	`statistics` - `competitors`	String	Unique ID for a competitor ex. `sr:competitor:4444` (Brisbane Lions)
`name`	`statistics` - `competitors`	String	Name for a competitor ex. `Brisbane Lions`
`qualifier`	`statistics` - `competitors`	String	Designation of a competitor for a sport event `home`, `away`
`virtual`	`statistics` - `competitors`	Boolean	Signifies a competitor is a virtual team whan `true`. Used for placeholder teams in TBD vs TBD matchups.

Game Stats (Player):

Attribute	Parent Element	Type	Description
`behinds`	`statistics` - `competitors` - `players`	Integer	Number of behinds for a player in a game
`disposals`	`statistics` - `competitors` - `players`	Integer	Number of disposals for a player in a game
`goals`	`statistics` - `competitors` - `players`	Integer	Number of goals for a player in a game
`handballs`	`statistics` - `competitors` - `players`	Integer	Number of handballs for a player in a game
`hitouts`	`statistics` - `competitors` - `players`	Integer	Number of hitouts for a player in a game
`kicks`	`statistics` - `competitors` - `players`	Integer	Number of kicks for a player in a game
`marks`	`statistics` - `competitors` - `players`	Integer	Number of marks for a player in a game
`super_goals`	`statistics` - `competitors` - `players`	Integer	Number of super goals for a player in a game
`tackles`	`statistics` - `competitors` - `players`	Integer	Number of tackles for a player in a game

Game Stats (Team):

Attribute	Parent Element	Type	Description
`behinds`	`statistics` - `competitors`	Integer	Number of behinds for a team in a game
`disposals`	`statistics` - `competitors`	Integer	Number of disposals for a team in a game
`free_kicks`	`statistics` - `competitors`	Integer	Number of free kicks for a team in a game
`goals`	`statistics` - `competitors`	Integer	Number of goals for a team in a game
`handballs`	`statistics` - `competitors`	Integer	Number of handballs for a team in a game
`hitouts`	`statistics` - `competitors`	Integer	Number of hitouts for a team in a game
`kicks`	`statistics` - `competitors`	Integer	Number of kicks for a team in a game
`marks_inside_50s`	`statistics` - `competitors`	Integer	Number of marks inside 50 for a team in a game
`marks`	`statistics` - `competitors`	Integer	Number of marks for a team in a game
`super_goals`	`statistics` - `competitors`	Integer	Number of super goals for a team in a game
`tackles`	`statistics` - `competitors`	Integer	Number of tackles for a team in a game