espn_nba_draft: *Get ESPN NBA Draft Pick Detail*

In hoopR: Access Men's Basketball Play by Play Data

Get ESPN NBA Draft Pick Detail

Description

Returns a single NBA draft pick. Defaults to the most recent NBA season's #1 overall pick. For a full draft, use espn_nba_draft().

Returns one row per round of the NBA draft (typically 2 rounds: 1st with 30 picks, 2nd with ~28 picks).

Returns one row per drafted athlete in a given NBA draft year.

Returns the current status of one NBA draft year (round, state, description). Live during the draft; static afterward.

Returns a single-row tibble with top-level draft-year metadata: year, number of rounds, display name, plus ⁠$ref⁠s for the deeper sub-resources (status, athletes, rounds) already wrapped by espn_nba_draft_status(), espn_nba_draft_athletes(), and espn_nba_draft_rounds().

Returns rich single-row detail for one drafted athlete in one NBA draft year: name, height, weight, position, pick (overall/round/team), and a ⁠$ref⁠ to the athlete's core-v2 profile. Use espn_nba_draft_athletes() to enumerate draftees for a year.

Usage

espn_nba_draft_pick(
  season = most_recent_nba_season(),
  round = 1L,
  pick = 1L,
  ...
)

espn_nba_draft_rounds(season = most_recent_nba_season(), ...)

espn_nba_draft_athletes(season = most_recent_nba_season(), ...)

espn_nba_draft_status(season = most_recent_nba_season(), ...)

espn_nba_season_draft(season = most_recent_nba_season(), ...)

espn_nba_draft_athlete_detail(
  season = most_recent_nba_season(),
  athlete_id,
  ...
)

espn_nba_draft(season = most_recent_nba_season(), ...)

Arguments

season	Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
round	Draft round (default 1).
pick	Pick number within the round (default 1).
...	Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...).
athlete_id	ESPN draftee identifier.

Details

Get ESPN NBA Draft Pick Detail

Get ESPN NBA Draft Rounds Summary

Get ESPN NBA Draft Athletes Index

Get ESPN NBA Draft Status

Calls the ESPN core-v2 endpoint ⁠https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{year}/draft/rounds⁠, which returns each round of the draft with its picks inlined as ⁠picks: [...]⁠. For historical seasons with no ESPN draft data the function returns an empty tibble rather than erroring.

Value

A single-row tibble.

col_name	types	description
league	character	League slug.
season	integer	Season year of the draft.
round	integer	Round number.
pick	integer	Pick within the round.
overall	integer	Overall pick number.
traded	logical	Whether the pick was traded.
trade_note	character	Trade note (if any).
status	character	Pick status name.
athlete_id	character	Drafted athlete's ESPN id.
team_id	character	Drafting team's ESPN id.
athlete_ref	character	⁠$ref⁠ to athlete.
team_ref	character	⁠$ref⁠ to team.

A tibble with one row per round.

A tibble of athlete IDs + ⁠$ref⁠ URLs.

A single-row tibble.

A single-row tibble.

A single-row tibble.

A hoopR_data tibble with one row per draft pick:

col_name	types	description
season	integer	Season identifier (4-digit year or 'YYYY-YY' string).
round	integer	Tournament / playoff round.
pick	integer
overall	integer	Overall.
traded	logical
trade_note	character
status	character	Status label.
athlete_id	character	Unique athlete identifier (ESPN).
athlete_ref	character
team_id	character	Unique team identifier.
team_ref	character

Athlete and team details (name, position, college, abbreviation) are not inlined in the draft response; resolve them via espn_nba_player_info() or espn_nba_team() using the returned IDs.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp(), espn_nba_freeagents(), espn_nba_player_contracts(), espn_nba_team_depthchart(), espn_nba_transactions()

Examples

  espn_nba_draft_pick(season = 2024, round = 1, pick = 1)


  espn_nba_draft_rounds(season = 2024)


  espn_nba_draft_athletes(season = 2024)


  espn_nba_draft_status(season = 2024)


  espn_nba_season_draft(season = 2024)


  espn_nba_draft_athlete_detail(season = 2024, athlete_id = 1966)


  espn_nba_draft(season = 2024)

hoopR documentation built on Aug. 25, 2026, 9:07 a.m.