Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Push Statistics

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

Syntax

https://api.sportradar.com/australianrules/{access_level}/{version}/stream/statistics/subscribe

Parameters

ParameterDescription
access_levelDefines the access level of your API key

production, trial
versionVersion number

v3
🔐

Authorization

Place your API key in the header for each request (x-api-key)


Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

Each query string parameter can be added with a preceding ampersand (&).

URL ParametersDescription
channelChannel type

channel=australianrules
competition_idCompetition id

Example: sr:competition:656
event_idEvent type

Example: event_id=score_change
formatFormat type

format=json, format=xml
season_idSeason id

Example: season_id=sr:season:79676
sport_event_idSport event id

Example: sport_event_id=sr:sport_event:16144572
sport_idSport 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")

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)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body
import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get(
    "https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe",
    headers=headers,
    allow_redirects=False
)

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

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 -X GET 'https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe' \
  -H 'x-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?&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)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body
import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get("https://api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe",
    params = {'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 -X GET 'api.sportradar.com/australianrules/trial/v3/stream/statistics/subscribe?&format=json&sport_event_id=sr:sport_event:16144572'
  -H 'x-api-key: {your_api_key}'


Response Sample

The above commands return json like this.



Data Points

Metadata
AttributeParent ElementTypeDescription
channelmetadataStringSport of the stream connection

ex. aussierules
competition_idmetadataStringUnique Id of a competition

ex. sr:competition:656
event_idmetadataStringType of timeline event

match_started, match_ended, score_change, period_score, period_start, break_start
formatmetadataStringFormat type of the response

json, xml
season_idmetadataStringUnique Id of a season

ex. sr:season:111244
sport_event_idmetadataStringUnique Id of a sport event

ex. sr:sport_event_id:49324739
sport_idmetadataStringUnique Id of a sport

ex. sr:sport:1
fromheartbeatIntegerUnix timestamp of the beginning of a heartbeat message

ex. 1713804799
toheartbeatIntegerUnix timestamp of the end of a heartbeat message

ex. 1713804804
intervalheartbeatIntegerInterval of a heartbeat message in seconds
typeheartbeatStringType of heartbeat message

ex. events, statistics
packageheartbeatStringPackage of a heartbeat message

ex. aussierules-v3
Sport Event Status
AttributeParent ElementTypeDescription
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
away_scoresport_event_statusIntegerTotal score for the away team in the game
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
home_scoresport_event_statusIntegerTotal score for the home team in the game
match_statussport_event_statusStringStatus 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_abandonedsport_event_statusBooleanSignifies a game was abandoned by a scout when true
statussport_event_statusStringStatus of a game

ex. not_started, 2nd_half, ended, awaiting_penalties

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the game winner

ex. sr:competitor:44
Period Scores
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scoresIntegerAway team period score
away_display_scoresport_event_status - period_scoresStringAway team period display score ('Number of Goals'.'Number of Points'.'Total')

ex. 5.5.35
home_scoresport_event_status - period_scoresIntegerHome team period score
home_display_scoresport_event_status - period_scoresStringHome team period display score ('Number of Goals'.'Number of Points'.'Total')

ex. 5.5.35
numbersport_event_status - period_scoresIntegerPeriod number
typesport_event_status - period_scoresStringPeriod type

regular_period, overtime, 1st_period, 2nd_period, 3rd_period, 4th_period, 1st_pause, 2nd_pause, 3rd_pause, interrupted
Player
AttributeParent ElementTypeDescription
idstatistics - competitors - playersStringUnique ID of a player

ex. sr:player:509236
namestatistics - competitors - playersStringName of a player

ex. Neale, Lachie
Competitor
AttributeParent ElementTypeDescription
abbreviationstatistics - competitorsStringAbbreviation for a competitor name

ex. BRI (Brisbane Lions)
age_groupstatistics - competitorsStringAge group of a competitor, when applicable

ex. U23
countrystatistics - competitorsStringCountry of a competitor

ex. Australia
country_codestatistics - competitorsStringCountry code of a competitor

ex. AUS (Australia)
genderstatistics - competitorsStringGender for a competitor

male, female
idstatistics - competitorsStringUnique ID for a competitor

ex. sr:competitor:4444 (Brisbane Lions)
namestatistics - competitorsStringName for a competitor

ex. Brisbane Lions
qualifierstatistics - competitorsStringDesignation of a competitor for a sport event

home, away
virtualstatistics - competitorsBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
Game Stats (Player)
AttributeParent ElementTypeDescription
behindsstatistics - competitors - playersIntegerNumber of behinds for a player in a game
disposalsstatistics - competitors - playersIntegerNumber of disposals for a player in a game
goalsstatistics - competitors - playersIntegerNumber of goals for a player in a game
handballsstatistics - competitors - playersIntegerNumber of handballs for a player in a game
hitoutsstatistics - competitors - playersIntegerNumber of hitouts for a player in a game
kicksstatistics - competitors - playersIntegerNumber of kicks for a player in a game
marksstatistics - competitors - playersIntegerNumber of marks for a player in a game
super_goalsstatistics - competitors - playersIntegerNumber of super goals for a player in a game
tacklesstatistics - competitors - playersIntegerNumber of tackles for a player in a game
Game Stats (Team)
AttributeParent ElementTypeDescription
behindsstatistics - competitorsIntegerNumber of behinds for a team in a game
disposalsstatistics - competitorsIntegerNumber of disposals for a team in a game
free_kicksstatistics - competitorsIntegerNumber of free kicks for a team in a game
goalsstatistics - competitorsIntegerNumber of goals for a team in a game
handballsstatistics - competitorsIntegerNumber of handballs for a team in a game
hitoutsstatistics - competitorsIntegerNumber of hitouts for a team in a game
kicksstatistics - competitorsIntegerNumber of kicks for a team in a game
marks_inside_50sstatistics - competitorsIntegerNumber of marks inside 50 for a team in a game
marksstatistics - competitorsIntegerNumber of marks for a team in a game
super_goalsstatistics - competitorsIntegerNumber of super goals for a team in a game
tacklesstatistics - competitorsIntegerNumber of tackles for a team in a game