Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Push Probable Pitchers

MLB Push Probable Pitchers provides real-time updates to probable pitchers for upcoming games.

Syntax

https://api.sportradar.com/mlb/{access_level}/stream/en/probables/subscribe?api_key={your_api_key}

Parameters

ParameterDescription
access_levelDefines the access level of your API key

production, trial
your_api_keyYour API key


Code Samples

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

url = URI("https://api.sportradar.com/mlb/trial/stream/en/probables/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/mlb/trial/stream/en/probables/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/mlb/trial/stream/en/probables/subscribe?api_key={your_api_key}'


Response Sample

The above commands return json like this.



Data Points

Metadata:
AttributeParent ElementTypeDescription
event_typemetadataStringType of an event
probable
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
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
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
abbrteamStringAbbreviation of a team
ex. TB (Tampa Bay)
Probable Pitchers:

Note: A new probable pitcher entry will appear under new, replacing the previous probable under previous.

AttributeParent ElementTypeDescription
first_nameprobable - previous / newStringFirst name of a probable pitcher
ex. Aaron
full_nameprobable - previous / newStringFull name of a probable pitcher
ex. Aaron Nola
suffixprobable - previous / newStringName suffix of a probable pitcher
ex. Jr.
idprobable - previous / newGUIDUnique ID of a probable pitcher
ex. ded1b30d-52ca-4eec-bce6-251b15b085ac
jersey_numberprobable - previous / newIntegerNumber of a probable pitcher's jersey
last_nameprobable - previous / newStringLast name of a probable pitcher
ex. Nola
preferred_nameprobable - previous / newStringPreferred name of a probable pitcher
ex. Aaron
updatedprobabledateTimeTimestamp of a probable pitcher update
ex. 2022-10-26T20:06:00Z
abbrprobable - teamStringAbbreviation of a team making a probable pitcher update
ex. PHI (Philadelphia)
idprobable - teamGUIDUnique ID of a team making a probable pitcher update
ex. 2142e1ba-3b40-445c-b8bb-f1f8b1054220
marketprobable - teamStringMarket name of a team making a probable pitcher update
ex. Philadelphia
nameprobable - teamStringName of a team making a probable pitcher update
ex. Phillies
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
ps_gamegameIntegerGame number in a series
ps_roundgameStringName of a series
ex. ALDS
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
scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance