Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Top Prospects

NBA Tops Prospects Provides a list of the top prospects for a given year.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 2 Seconds

Data Updates: Prospects are added after the NCAA Men's Basketball season ends and players declare, typically in May.

📘

Covering the NBA Draft

Learn how to use Top Prospects to display the most highly anticipated players entering the NBA Draft in our NBA Draft integration scenario.


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. 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
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
aliasprospect - conferenceStringAlias of a prospect's conference

ex. SEC
idprospect - conferenceGUIDUnique ID of a prospect's conference

ex. 9ed9d01e-977c-4ba7-ac7d-64035039461c
nameprospect - conferenceStringName of a prospect's conference

ex. Southeastern
aliasdivisionStringAlias of a prospect's division

ex. D1
iddivisionGUIDUnique ID of a prospect's division

ex. c5a8d640-5093-4044-851d-2c562e929994
namedivisionStringName of a prospect's division

ex. NCAA Division I
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
aliasprospect - teamStringAbbreviation of a prospect's team

ex. Iowa
idprospect - teamGUIDUnique ID of a prospect's team

ex. c10544de-e3bd-4776-ba2e-83df8c017fd1
marketprospect - teamStringMarket name of a prospect's team

ex. Iowa
nameprospect - teamStringProspect's team name

ex. Hawkeyes
Venue
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue

ex. 620 Atlantic Avenue
cityvenueStringCity of a venue

ex. Brooklyn
countryvenueStringCountry of a venue

ex. USA
namevenueStringName of a venue

ex. Barclays Center
statevenueStringState or province of a venue

ex. NY
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
enum
required
Defaults to 2025

NBA Draft year in YYYY format

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json