Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Push Draft Picks

NFL Push Draft Picks provides pre-draft pick order with real-time (push enabled) pick selections during the draft.

Syntax

https://api.sportradar.com/draft/nfl/{access_level}/stream/en/picks/subscribe?api_key={your_api_key}

Parameters

ParameterDescription
access_levelDefines the access level of your API key

production, trial
your_api_keyYour 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.

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.

ParameterDescription
draftDraft id

Example: draft=sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9


Code Samples

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

url = URI("https://api.sportradar.us/draft/nfl/trial/stream/en/picks/subscribe?api_key={your_api_key}&draft=sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9&league=NFL")

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/draft/nfl/trial/stream/en/picks/subscribe",
    params = {'api_key': 'your_api_key', 'draft': 'sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9', 'league': 'NFL'},
    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.us/draft/nfl/trial/stream/en/picks/subscribe?api_key={your_api_key}&draft=sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9&league=NFL'

Samples with Query String Params

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

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


Response Sample

The above commands return json like this.



Data Points

Draft Info:
AttributeParent ElementTypeDescription
end_datedraftDateEnd date of a draft
ex. 2022-04-30
iddraftGUIDUnique ID of a draft
ex. 01c63362-299c-48a0-b725-63fa18fca261
start_datedraftDateStart date of a draft
ex. 2022-04-30
statusdraftStringStatus of a draft
ex. closed
aliaspick - teamStringDraft team alias
ex. MIN (Minnesota)
idpick - teamGUIDUnique ID of a draft team
ex. 82d2d380-3834-4938-835f-aec541e5ece7
marketpick - teamStringDraft team market name
ex. Minnesota
namepick - teamStringDraft team name
ex. Vikings
yeardraftIntegerYear of a draft
Pick Info:
AttributeParent ElementTypeDescription
compensatorypickBooleanSignifies a compensatory draft pick
idpickGUIDUnique ID of a draft pick
ex. ca6b8dae-e835-49e4-9638-b30cdd3969a8
numberpickIntegerNumber of a draft pick within a round
overallpickIntegerOverall number of a draft pick
tradedpickBooleanSignifies a traded draft pick
idpick - trades - tradeGUIDUnique ID of a trade
ex. 3fc4ffa0-fe54-4d9a-bf53-e85df0e2cefd
Round Info:
AttributeParent ElementTypeDescription
end_dateroundDateEnd date of a round
ex. 2022-04-30
idroundGUIDUnique ID of a round
ex. 2e9eee59-fdc4-4dbf-bafa-b1cc80976fdb
numberroundIntegerNumber of a round
start_dateroundDateStart date of a round
ex. 2022-04-30
statusroundStringStatus of a round
ex. closed
Broadcast:
AttributeParent ElementTypeDescription
channelbroadcastStringName of the game's broadcast channel
internetbroadcastStringName of the game's internet stream
networkbroadcastStringName of the game's broadcast network
ex. Amazon Prime Video
League:
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league
ex. NFL
idleagueGUIDUnique ID of a league
ex. 3c6d318a-6164-4290-9bbc-bf9bb21cc4b8
nameleagueStringName of a league
ex. National Football League
Prospects:
AttributeParent ElementTypeDescription
birth_placeprospectStringBirthplace of a prospect
ex. Tyler, TX, USA
experienceprospectStringExperience of a college prospect
ex. JR or SR
first_nameprospectStringFirst name of a prospect
ex. Patrick
heightprospectIntegerHeight in inches
idprospectGUIDUnique prospect/draft ID of a player
ex. 11cad59d-90dd-449c-a839-dddaba4fe16c
last_nameprospectStringLast name of a prospect
ex. Mahomes
league_idprospectGUIDThe NFL API ID of a player.

This will appear once the player has been drafted and exported to the NFL API. Typically, it happens the day after they are drafted.
ex. 5250f409-d4d7-48ac-adf4-35c3561ffad1
nameprospectStringFull name of a prospect
ex. Patrick Mahomes
positionprospectStringPosition of a prospect

See our FAQ for a list of valid positions
publishableprospectBooleanSignifies a prospect should appear in the feed
source_idprospectGUIDUnique player ID from a prospect's source (for example, the NCAA Football API)
ex. 9fe7c9f9-5830-4e22-953d-054a44342323
team_nameprospectStringName of college or team
ex. Texas Tech
top_prospectprospectBooleanSignifies a top prospect
weightprospectDecimalWeight in lbs
Metadata:
AttributeParent ElementTypeDescription
leaguemetadataStringAlias of a league
ex. NFL
draftmetadataStringUnique ID of a draft
ex. sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9
localemetadataStringLanguage code
ex. en (English)
operationmetadataStringOperation of an update
update, delete
versionmetadataStringVersion of the API
ex. v1