Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Push Linescores

MLB Push Linescores provides real-time high level scoring by inning.

Syntax

https://api.sportradar.com/mlb/{access_level}/stream/en/linescore/subscribe

Parameters

ParameterDescription
access_levelDefines the access level of your API key

production, trial
🔐

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 (&).

ParameterDescription
matchGame id

Example: match=sd:match:7779b2fe-70ad-4823-8c6d-9e2453576e2a
statusGame status

inprogress, created

Example: status=inprogress


Code Samples

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

url = URI("https://api.sportradar.com/mlb/trial/stream/en/linescore/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/mlb/trial/stream/en/linescore/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/mlb/trial/stream/en/linescore/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/mlb/trial/stream/en/linescore/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d")

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/mlb/trial/stream/en/linescore/subscribe",
    params = {'status': 'inprogress', 'match': 'sd:match:673b459c-7506-4c11-9273-1b9502537f1d'},
    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/mlb/trial/stream/en/linescore/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d'
  -H 'x-api-key: {your_api_key}'


Response Samples

The above commands return json like this.


Simulations

Check out our Simulations to replay actual games at any time, on your own schedule. Push simulations are available as well.



Data Points

Metadata
AttributeParent ElementTypeDescription
leaguemetadataStringAlias of a league

ex. MLB
localemetadataStringLanguage code

ex. en (English)
matchmetadataGUIDUnique ID of a game

ex. sd:match:30ad883f-aeaf-4e6b-9fd9-a1cc0b6c4679
operationmetadataStringOperation of an update

create, update, delete
statusmetadataStringThe status of a game

scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance
versionmetadataStringVersion of the API

ex. v6.5
Boxscore
AttributeParent ElementTypeDescription
abbrawayStringAbbreviation of the away team

ex. MIN (Minnesota)
errorsawayIntegerNumber of errors for the away team
hitsawayIntegerNumber of hits for the away team
idawayGUIDUnique ID of the away team

ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
idaway-probable_pitcherGUIDUnique ID of the away team's probable pitcher

ex. 515af486-d938-4cb6-90e4-943323a5737c
marketawayStringMarket name of the away team

ex. Colorado
nameawayStringTeam name of the away team

ex. Rockies
runsawayIntegerNumber of runs for the away team in the game
abbrhomeStringAbbreviation of the home team

ex. CLE (Cleveland)
errorshomeIntegerNumber of errors for the home team
hitshomeIntegerNumber of hits for the home team
idhomeGUIDUnique ID of the home team

ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
idhome-probable_pitcherGUIDUnique ID of the home team's probable pitcher

ex. 515af486-d938-4cb6-90e4-943323a5737c
markethomeStringMarket name of the home team

ex. Cleveland
namehomeStringTeam name of the home team

ex. Guardians
runshomeIntegerNumber of runs for the home team in the game
awaylinescoreIntegerNumber of runs for the away team in the game
homelinescoreIntegerNumber of runs for the home team in the game
inninglinescoreIntegerNumber of the current inning
abbrteamStringAbbreviation of a team

ex. TB (Tampa Bay)
idteamGUIDUnique ID of a team

ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team

ex. Tampa Bay
nameteamStringTeam name

ex. Rays
Game
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team

ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
coveragegameStringCoverage level of a game

full, boxscore
double_headergameBooleanSignifies whether a game is part of a double header
day_nightgameStringSignifies a day or night game

D, N
entry_modegameStringSignifies the type of data entry

STOMP, LDE
home_teamgameGUIDUnique ID of the home team

ex. ef64da7f-cfaf-4300-87b0-9313386b977c
idgameGUIDUnique ID of the game

ex. 1b554f5e-d8b7-4268-95da-2f4191015c84
game_numbergameIntegerNumber of the game
referencegameStringUnique MLBAM ID of a game
scheduledgamedateTimeScheduled date and time of a game

ex. 2022-09-25T20:10:00+00:00
split_squadgameBooleanSignifies a Spring Training split squad game
statusgameStringThe status of a game. See our FAQ for all statuses and their definitions.

scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance
Play-By-Play - Count
AttributeParent ElementTypeDescription
ballsboxscoreIntegerNumber of balls in an at bat
outsboxscoreIntegerNumber of outs in an at bat
inning_halfboxscoreStringInning half of a player entering the game

T, B
inningboxscoreIntegerInning of a player entering the game
pitch_countboxscoreIntegerNumber of pitches in an at bat
strikesboxscoreIntegerNumber of strikes in an at bat
Current Baserunners
AttributeParent ElementTypeDescription
baserunnersIntegerRunner's base at the end of a play
first_namerunnersStringFirst name of the current runner

ex. Markus
full_namerunnersStringFull name of the current runner

ex. Mookie Betts
suffixrunnersStringName suffix of the current runner

ex. Jr.
jersey_numberrunnersIntegerNumber of the current runner's jersey
last_namerunnersStringLast name of the current runner

ex. Betts
outoutcome-runnerBooleanSignifies the runner was out on a play
preferred_namerunnersStringPreferred name of the current runner

ex. Mookie
Current Hitter
AttributeParent ElementTypeDescription
first_namehitterStringFirst name of the current hitter

ex. Markus
full_namehitterStringFull name of the current hitter

ex. Mookie Betts
suffixhitterStringName suffix of the current hitter

ex. Jr.
hitter_handhitterBooleanHandedness of a hittter
jersey_numberhitterIntegerNumber of the current hitter's jersey
last_namehitterStringLast name of the current hitter

ex. Betts
lineup_orderhitterIntegerLineup order number of the current hitter
lineup_positionhitterStringLineup position of the current hitter
preferred_namehitterStringPreferred name of the current hitter

ex. Mookie
Current Pitcher
AttributeParent ElementTypeDescription
first_namepitcherStringFirst name of the current pitcher

ex. Clayton
full_namepitcherStringFull name of the current pitcher

ex. Clayton Kershaw
suffixpitcherStringName suffix of the current pitcher

ex. Jr.
jersey_numberpitcherIntegerNumber of the current pitcher's jersey
last_namepitcherStringLast name of the current pitcher

ex. Kershaw
pitch_countpitcherIntegerPitch count of the current pitcher
pitch_handpitcherStringPitching hand of the current pitcher
preferred_namepitcherStringPreferred name of the current pitcher

ex. Clayton