Skip to contents

Get ESPN NBA Draft Picks

Get ESPN NBA Draft Picks

Usage

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

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...).

Value

A hoopR_data tibble with one row per draft pick:

col_nametypesdescription
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).
roundintegerTournament / playoff round.
pickinteger
overallintegerOverall.
tradedlogical
trade_notecharacter
statuscharacterStatus label.
athlete_idcharacterUnique athlete identifier (ESPN).
athlete_refcharacter
team_idcharacterUnique team identifier.
team_refcharacter

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

Details

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.

See also

Other ESPN NBA Functions: espn_nba_athlete_awards(), espn_nba_athlete_career_stats(), espn_nba_athlete_contract(), espn_nba_athlete_contracts(), espn_nba_athlete_eventlog(), espn_nba_athlete_eventlog_v2(), espn_nba_athlete_gamelog(), espn_nba_athlete_info(), espn_nba_athlete_overview(), espn_nba_athlete_seasons(), espn_nba_athlete_splits(), espn_nba_athlete_statisticslog(), espn_nba_athlete_stats(), espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_odds(), espn_nba_event_officials(), espn_nba_event_powerindex(), espn_nba_event_predictor(), espn_nba_event_probabilities(), espn_nba_event_propbets(), espn_nba_event_situation(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_rosters(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_box(), espn_nba_player_stats(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_nba_draft(season = 2024)
#> ── ESPN NBA Draft Picks from ESPN.com ─────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-19 01:33:46 UTC
#> # A tibble: 58 × 11
#>    season round  pick overall traded trade_note status    athlete_id athlete_ref
#>     <int> <int> <int>   <int> <lgl>  <chr>      <chr>     <chr>      <chr>      
#>  1   2024     1     1       1 FALSE  NA         SELECTIO… 108206     http://spo…
#>  2   2024     1     2       2 FALSE  NA         SELECTIO… 108204     http://spo…
#>  3   2024     1     3       3 FALSE  From BKN   SELECTIO… 108231     http://spo…
#>  4   2024     1     4       4 FALSE  NA         SELECTIO… 108107     http://spo…
#>  5   2024     1     5       5 FALSE  NA         SELECTIO… 108202     http://spo…
#>  6   2024     1     6       6 FALSE  NA         SELECTIO… 108207     http://spo…
#>  7   2024     1     7       7 FALSE  NA         SELECTIO… 108106     http://spo…
#>  8   2024     1     8       8 TRUE   From TOR   SELECTIO… 108142     http://spo…
#>  9   2024     1     9       9 FALSE  NA         SELECTIO… 108147     http://spo…
#> 10   2024     1    10      10 FALSE  NA         SELECTIO… 108119     http://spo…
#> # ℹ 48 more rows
#> # ℹ 2 more variables: team_id <chr>, team_ref <chr>
# }