Skip to contents

Retrieve Homerun Derby Players

Source: R/mlb_homerun_derby.R
mlb_homerun_derby_players.Rd

Retrieve Homerun Derby Players

Usage

mlb_homerun_derby_players(game_pk)

Arguments

game_pk

The game_pk for which you want to return data

Value

Returns a tibble with the following columns

col_nametypesdescription
game_pkintegerMLB game primary key for the Home Run Derby event.
event_namecharacterEvent name (e.g. 'All-Star Workout Day: Home Run Derby').
event_datecharacterEvent date-time in ISO 8601 (e.g. '2017-07-11T00:00:00Z').
event_type_codecharacterSingle-letter event type code (e.g. 'O').
event_type_namecharacterEvent type name (e.g. 'Other').
venue_idintegerMLB venue id hosting the event.
venue_namecharacterVenue name (e.g. 'Marlins Park').
player_idintegerMLB player id of the participant.
player_full_namecharacterParticipant full name.
player_linkcharacterAPI relative link to the player.
player_first_namecharacterParticipant first name.
player_last_namecharacterParticipant last name.
player_primary_numbercharacterParticipant primary jersey number.
player_birth_datecharacterParticipant birth date (YYYY-MM-DD).
player_current_ageintegerParticipant current age in years.
player_birth_citycharacterParticipant birth city.
player_birth_state_provincecharacterParticipant birth state or province.
player_birth_countrycharacterParticipant birth country.
player_heightcharacterParticipant height (e.g. "6' 5\"").
player_weightintegerParticipant weight in pounds.
player_activelogicalWhether the participant is currently an active player.
player_use_namecharacterParticipant preferred display first name.
player_middle_namecharacterParticipant middle name.
player_boxscore_namecharacterParticipant short box score name.
player_nick_namecharacterParticipant nickname.
player_gendercharacterParticipant gender code (e.g. 'M').
player_is_playerlogicalWhether the person is classified as a player.
player_is_verifiedlogicalWhether the player profile is verified.
player_draft_yearintegerYear the participant was drafted.
player_pronunciationcharacterPhonetic pronunciation of the participant's name.
player_mlb_debut_datecharacterParticipant MLB debut date (YYYY-MM-DD).
player_name_first_lastcharacterParticipant name in first-last order.
player_name_slugcharacterURL slug for the participant (name plus id).
player_first_last_namecharacterParticipant name in first-last order.
player_last_first_namecharacterParticipant name in last, first order.
player_last_init_namecharacterParticipant name as last, first initial.
player_init_last_namecharacterParticipant name as first initial last.
player_full_fml_namecharacterParticipant full first-middle-last name.
player_full_lfm_namecharacterParticipant full last, first-middle name.
player_strike_zone_topnumericTop of the participant's strike zone (feet).
player_strike_zone_bottomnumericBottom of the participant's strike zone (feet).
player_name_matrilinealcharacterParticipant matrilineal name when provided.
player_current_team_idintegerParticipant current team id.
player_current_team_namecharacterParticipant current team name.
player_current_team_linkcharacterAPI relative link to the current team.
player_current_team_seasonintegerSeason of the current team reference.
player_current_team_team_codecharacterCurrent team three-letter team code.
player_current_team_file_codecharacterCurrent team file code.
player_current_team_abbreviationcharacterCurrent team abbreviation (e.g. 'NYY').
player_current_team_team_namecharacterCurrent team short team name (e.g. 'Yankees').
player_current_team_location_namecharacterCurrent team location name.
player_current_team_first_year_of_playcharacterFranchise first year of play.
player_current_team_short_namecharacterCurrent team short name.
player_current_team_franchise_namecharacterCurrent team franchise name.
player_current_team_club_namecharacterCurrent team club name.
player_current_team_all_star_statuscharacterCurrent team all-star status flag.
player_current_team_activelogicalWhether the current team is active.
player_current_team_parent_org_namecharacterParent organization name (minors).
player_current_team_parent_org_idintegerParent organization id (minors).
player_current_team_venue_idintegerCurrent team home venue id.
player_current_team_venue_namecharacterCurrent team home venue name.
player_current_team_venue_linkcharacterAPI relative link to the team venue.
player_current_team_spring_venue_idintegerCurrent team spring training venue id.
player_current_team_spring_venue_linkcharacterAPI relative link to the spring venue.
player_current_team_league_idintegerCurrent team league id (e.g. 103, 104).
player_current_team_league_namecharacterCurrent team league name.
player_current_team_league_linkcharacterAPI relative link to the league.
player_current_team_division_idintegerCurrent team division id.
player_current_team_division_namecharacterCurrent team division name.
player_current_team_division_linkcharacterAPI relative link to the division.
player_current_team_sport_idintegerCurrent team sport id (1 for MLB).
player_current_team_sport_linkcharacterAPI relative link to the sport.
player_current_team_sport_namecharacterCurrent team sport name.
player_current_team_spring_league_idintegerSpring league id.
player_current_team_spring_league_namecharacterSpring league name (e.g. 'Grapefruit League').
player_current_team_spring_league_linkcharacterAPI relative link to the spring league.
player_current_team_spring_league_abbreviationcharacterSpring league abbreviation (e.g. 'GL').
player_primary_position_codecharacterParticipant primary position code.
player_primary_position_namecharacterParticipant primary position name.
player_primary_position_typecharacterParticipant primary position type (e.g. 'Hitter').
player_primary_position_abbreviationcharacterParticipant primary position abbreviation (e.g. 'DH').
player_bat_side_codecharacterParticipant batting side code (e.g. 'R').
player_bat_side_descriptioncharacterParticipant batting side description (e.g. 'Right').
player_pitch_hand_codecharacterParticipant throwing hand code (e.g. 'R').
player_pitch_hand_descriptioncharacterParticipant throwing hand description (e.g. 'Right').
venue_linkcharacterAPI relative link to the event venue.
is_multi_daylogicalWhether the event spans multiple days.
is_primary_calendarlogicalWhether the event is on the primary calendar.
file_codecharacterInternal file code for the event.
event_numberintegerEvent number identifier.
public_facinglogicalWhether the event is public facing.

Examples

# \donttest{
  try(mlb_homerun_derby_players(game_pk = 511101))
#> ── MLB Homerun Derby Players data from MLB.com ────── baseballr 2.0.0 ──
#> ℹ Data updated: 2026-06-12 14:09:38 UTC
#> # A tibble: 8 × 91
#>   game_pk event_name event_date event_type_code event_type_name venue_id
#>     <int> <chr>      <chr>      <chr>           <chr>              <int>
#> 1  511101 All-Star … 2017-07-1… O               Other               4169
#> 2  511101 All-Star … 2017-07-1… O               Other               4169
#> 3  511101 All-Star … 2017-07-1… O               Other               4169
#> 4  511101 All-Star … 2017-07-1… O               Other               4169
#> 5  511101 All-Star … 2017-07-1… O               Other               4169
#> 6  511101 All-Star … 2017-07-1… O               Other               4169
#> 7  511101 All-Star … 2017-07-1… O               Other               4169
#> 8  511101 All-Star … 2017-07-1… O               Other               4169
#> # ℹ 85 more variables: venue_name <chr>, player_id <int>,
#> #   player_full_name <chr>, player_link <chr>, player_first_name <chr>,
#> #   player_last_name <chr>, player_primary_number <chr>,
#> #   player_birth_date <chr>, player_current_age <int>,
#> #   player_birth_city <chr>, player_birth_state_province <chr>,
#> #   player_birth_country <chr>, player_height <chr>,
#> #   player_weight <int>, player_active <lgl>, player_use_name <chr>, …
# }