Skip to contents

Find game_pk values for professional baseball games (major and minor leagues) via the MLB api https://www.mlb.com/

Usage

mlb_game_pks(date, level_ids = c(1))

Arguments

date

The date for which you want to find game_pk values for MLB games

level_ids

A numeric vector with ids for each level where game_pks are desired. See below for a reference of level ids.

Value

Returns a tibble that includes game_pk values and additional information for games scheduled or played with the following columns:

col_nametypes
game_pkinteger
linkcharacter
gameTypecharacter
seasoncharacter
gameDatecharacter
officialDatecharacter
isTielogical
gameNumberinteger
publicFacinglogical
doubleHeadercharacter
gamedayTypecharacter
tiebreakercharacter
calendarEventIDcharacter
seasonDisplaycharacter
dayNightcharacter
scheduledInningsinteger
reverseHomeAwayStatuslogical
inningBreakLengthinteger
gamesInSeriesinteger
seriesGameNumberinteger
seriesDescriptioncharacter
recordSourcecharacter
ifNecessarycharacter
ifNecessaryDescriptioncharacter
status.abstractGameStatecharacter
status.codedGameStatecharacter
status.detailedStatecharacter
status.statusCodecharacter
status.startTimeTBDlogical
status.abstractGameCodecharacter
teams.away.scoreinteger
teams.away.isWinnerlogical
teams.away.splitSquadlogical
teams.away.seriesNumberinteger
teams.away.leagueRecord.winsinteger
teams.away.leagueRecord.lossesinteger
teams.away.leagueRecord.pctcharacter
teams.away.team.idinteger
teams.away.team.namecharacter
teams.away.team.linkcharacter
teams.home.scoreinteger
teams.home.isWinnerlogical
teams.home.splitSquadlogical
teams.home.seriesNumberinteger
teams.home.leagueRecord.winsinteger
teams.home.leagueRecord.lossesinteger
teams.home.leagueRecord.pctcharacter
teams.home.team.idinteger
teams.home.team.namecharacter
teams.home.team.linkcharacter
venue.idinteger
venue.namecharacter
venue.linkcharacter
content.linkcharacter

Details

Level IDs:

The following IDs can be passed to the level_ids argument:

1 = MLB 11 = Triple-A 12 = Doubl-A 13 = Class A Advanced 14 = Class A 15 = Class A Short Season 5442 = Rookie Advanced 16 = Rookie 17 = Winter League

Examples

# \donttest{
  try(mlb_game_pks("2019-04-29"))
#> ── MLB Game Pks data from MLB.com ─────────────────── baseballr 1.6.0 ──
#>  Data updated: 2024-04-13 21:56:17 UTC
#> # A tibble: 9 × 55
#>   game_pk gameGuid     link  gameType season gameDate officialDate isTie
#>     <int> <chr>        <chr> <chr>    <chr>  <chr>    <chr>        <lgl>
#> 1  565909 f66a1949-a0… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 2  566001 204d367a-81… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 3  565040 455fea2b-f0… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 4  567173 220d5ff9-d2… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 5  566975 08410240-7e… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 6  567566 2aeee258-c3… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 7  567275 8bbe8497-80… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 8  565717 62a6f6de-55… /api… R        2019   2019-04… 2019-04-29   FALSE
#> 9  566484 0680b3a3-16… /api… R        2019   2019-04… 2019-04-29   FALSE
#> # ℹ 47 more variables: gameNumber <int>, publicFacing <lgl>,
#> #   doubleHeader <chr>, gamedayType <chr>, tiebreaker <chr>,
#> #   calendarEventID <chr>, seasonDisplay <chr>, dayNight <chr>,
#> #   scheduledInnings <int>, reverseHomeAwayStatus <lgl>,
#> #   inningBreakLength <int>, gamesInSeries <int>,
#> #   seriesGameNumber <int>, seriesDescription <chr>,
#> #   recordSource <chr>, ifNecessary <chr>, …
# }