Learn R Programming

hoopR (version 3.1.0)

espn_nba_draft_pick: 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 $refs 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(), ...)

Value

A single-row tibble.

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year of the draft.
roundintegerRound number.
pickintegerPick within the round.
overallintegerOverall pick number.
tradedlogicalWhether the pick was traded.
trade_notecharacterTrade note (if any).
statuscharacterPick status name.
athlete_idcharacterDrafted athlete's ESPN id.
team_idcharacterDrafting team's ESPN id.
athlete_refcharacter$ref to athlete.
team_refcharacter$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_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_player_info()

or espn_nba_team() using the returned IDs.

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.

Author

Saiem Gilani

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.

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

Run this code
# \donttest{
  espn_nba_draft_pick(season = 2024, round = 1, pick = 1)
# }
# \donttest{
  espn_nba_draft_rounds(season = 2024)
# }
# \donttest{
  espn_nba_draft_athletes(season = 2024)
# }
# \donttest{
  espn_nba_draft_status(season = 2024)
# }
# \donttest{
  espn_nba_season_draft(season = 2024)
# }
# \donttest{
  espn_nba_draft_athlete_detail(season = 2024, athlete_id = 1966)
# }
# \donttest{
  espn_nba_draft(season = 2024)
# }

Run the code above in your browser using DataLab