Docs
Coverage MatrixDocumentationRelease LogLog In

Push Draft Picks

NBA Push Draft Picks This endpoint retrieves pre-draft pick order with real-time pick selections during the draft.

Syntax

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

Replace the placeholders with the following path parameters.

ParameterDescription
access_levelDefines the access level of your API key as Production (production), Trial (trial), or Simulation (simulation).
your_api_keyYour API key.

Optional Query String Parameters

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

๐Ÿ“˜

Note

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:

ParameterDescription
draftDraft id expressed as: sd:draft:{draft_id}.
Example: draft=sd:draft:e04e45a4-7a76-470c-a3ee-ed6bd56583f1

Code Samples

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

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

Samples with Query String Params

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

url = URI("https://api.sportradar.com/draft/nba/trial/stream/en/picks/subscribe?api_key={your_api_key}&draft=sd:draft:e04e45a4-7a76-470c-a3ee-ed6bd56583f1&league=NBA")

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/nba/trial/stream/en/picks/subscribe",
    params = {'api_key': 'your_api_key', 'draft': 'sd:draft:e04e45a4-7a76-470c-a3ee-ed6bd56583f1', 'league': 'NBA'},
    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/nba/trial/stream/en/picks/subscribe?api_key={your_api_key}&draft=sd:draft:e04e45a4-7a76-470c-a3ee-ed6bd56583f1&league=NBA'

Response Sample

The above commands return json like this.



Data Points

Draft Info:
AttributeParent ElementTypeDescription
end_datedraftDateEnd date of a draft
ex. 2022-06-23
iddraftGUIDUnique ID of a draft
ex. 01c63362-299c-48a0-b725-63fa18fca261
start_datedraftDateStart date of a draft
ex. 2022-06-23
statusdraftStringStatus of a draft
scheduled, inprogress, complete, closed
aliaspick - teamStringDraft team alias
ex. DEN (Denver)
idpick - teamGUIDUnique ID of a draft team
ex. 583ed102-fb46-11e1-82cb-f4ce4684ea4c
marketpick - teamStringDraft team market name
ex. Denver
namepick - teamStringDraft team name
ex. Nuggets
yeardraftIntegerYear of a draft
Pick Info:
AttributeParent ElementTypeDescription
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 - tradesGUIDUnique ID of a trade
ex. 3fc4ffa0-fe54-4d9a-bf53-e85df0e2cefd
Round Info:
AttributeParent ElementTypeDescription
end_dateroundDateEnd date of a round
ex. 2022-06-23
idroundGUIDUnique ID of a round
ex. 27b93f2c-95fb-4ba6-80ea-d50c95f7d1a4
numberroundIntegerNumber of a round
start_dateroundDateStart date of a round
ex. 2022-06-23
statusroundStringStatus of a round
ex. closed
Broadcast:
AttributeParent ElementTypeDescription
channelbroadcastStringName of the draft's broadcast channel
networkbroadcastStringName of the draft's broadcast network
ex. ABC, ESPN
League:
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league
ex. NBA
idleagueGUIDUnique ID of a league
ex. 4353138d-4c22-4396-95d8-5f587d2df25c
nameleagueStringName of a league
ex. NBA
Metadata:
AttributeParent ElementTypeDescription
draftmetadataGUIDUnique ID of a draft
ex. sd:draft:e04e45a4-7a76-470c-a3ee-ed6bd56583f1
leaguemetadataStringAlias of a league
ex. NBA
localemetadataStringLanguage code
ex. en (English)
operationmetadataStringOperation of an update
update, delete
versionmetadataStringVersion of the API
ex. v7
Prospects:
AttributeParent ElementTypeDescription
birth_placeprospectStringBirthplace of a prospect
ex. Cedar Rapids, IA, USA
experienceprospectStringExperience of a college prospect
ex. JR or SR
first_nameprospectStringFirst name of a prospect
ex. Keegan
heightprospectIntegerHeight in inches
idprospectGUIDUnique prospect/draft ID of a player
ex. 0245fbf2-e24f-41a7-8322-d39caf6d2b37
last_nameprospectStringLast name of a prospect
ex. Murray
league_idprospectGUIDThe NBA API ID of a player.

This will appear once the player has been drafted and exported to the NBA API. Typically, it happens the day after they are drafted.
ex. 7494fbb4-5ac7-43ee-b91a-8859532f548b
nameprospectStringFull name of a prospect
ex. Keegan Murray
positionprospectStringPosition of a prospect
See our FAQ for a list of valid positions
source_idprospectGUIDUnique player ID from a prospect's source (for example, the NCAA Men's Basketball API)
ex. be83df8e-0fb6-4ee5-9c1c-4151a5223680
top_prospectprospectBooleanSignifies a top prospect
weightprospectIntegerWeight in lbs
Team:
AttributeParent ElementTypeDescription
aliaspick - teamStringAbbreviation of a team
ex. SAC (Sacramento)
idpick - teamGUIDUnique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketpick - teamStringMarket name of a team
ex. Sacramento
namepick - teamStringTeam name
ex. Kings