This function allows you to scrape all leaderboard statistics (basic and advanced) from FanGraphs.com.
Usage
fg_team_batter(
age = "",
pos = "all",
stats = "bat",
lg = "all",
qual = "y",
startseason = "2023",
endseason = "2023",
startdate = "",
enddate = "",
month = "0",
hand = "",
team = "0,ts",
pageitems = "1000",
pagenum = "1",
ind = "0",
rost = "0",
players = "",
type = "8",
postseason = "",
sortdir = "default",
sortstat = "WAR"
)Arguments
- age
(integer) Age of players
- pos
(character) Position of players, defaults to "all". To exclude pitchers, use "np".
- stats
(character) Statistic to return. Defaults to "bat".
- lg
(character) League to return. Defaults to "all". Options are "al", "nl", or "all".
- qual
(character) Whether you want only batters/pitchers that qualified in a given season, or the minimum number of plate appearances for inclusion. If you only want qualified hitters, use qual. If a minimum number of plate appearaces/innings pitched, use the number desired. Defaults to "y".
- startseason
(character) Season for which you want to scrape the data.
- endseason
(character) Last season for which you want data.
- startdate
(character) Start date for which you want data.
- enddate
(character) End date for which you want data.
- month
(character) Month for which you want data.
- hand
(character) Handedness of batter. Options are "L", "R", or "B". Empty string returns all.
- team
(character) Teams for which you want data, comma separated.
- pageitems
(character) Number of items per page.
- pagenum
(character) Page number.
- ind
(character) Whether or not to break the seasons out individual, or roll them up together. 1 = split seasons, 0 = aggregate seasons.
- rost
(character) Whether or not to include players on the roster. 1 = include, 0 = exclude.
- players
(character) Whether or not to include players on the roster. 1 = include only active roster players, 0 = exclude.
- type
(character) Defaults to 8, which is the standard leaderboard. The values for the leaderboards appear to go to from type = 0 to 48+, which correspond to links on the leaderboard page.
- postseason
(logical) Whether or not to include postseason data. TRUE = include postseason, FALSE = exclude postseason.
- sortdir
(character) Sort direction. Options are "asc" or "desc" or "default".
- sortstat
(character) Sort by stat. Default is "WAR".
Value
A data frame of batter data.
| col_name | types |
| Season | integer |
| team_name | character |
| SeasonMin | integer |
| SeasonMax | integer |
| G | integer |
| AB | integer |
| PA | integer |
| H | integer |
| 1B | integer |
| 2B | integer |
| 3B | integer |
| HR | integer |
| R | integer |
| RBI | integer |
| BB | integer |
| IBB | integer |
| SO | integer |
| HBP | integer |
| SF | integer |
| SH | integer |
| GDP | integer |
| SB | integer |
| CS | integer |
| AVG | numeric |
| GB | integer |
| FB | integer |
| LD | integer |
| IFFB | integer |
| Pitches | integer |
| Balls | integer |
| Strikes | integer |
| IFH | integer |
| BU | integer |
| BUH | integer |
| BB_pct | numeric |
| K_pct | numeric |
| BB_K | numeric |
| OBP | numeric |
| SLG | numeric |
| OPS | numeric |
| ISO | numeric |
| BABIP | numeric |
| GB_FB | numeric |
| LD_pct | numeric |
| GB_pct | numeric |
| FB_pct | numeric |
| IFFB_pct | numeric |
| HR_FB | numeric |
| IFH_pct | numeric |
| BUH_pct | numeric |
| TTO_pct | numeric |
| wOBA | numeric |
| wRAA | numeric |
| wRC | numeric |
| Batting | numeric |
| Fielding | numeric |
| Replacement | numeric |
| Positional | numeric |
| wLeague | numeric |
| CFraming | numeric |
| Defense | numeric |
| Offense | numeric |
| RAR | numeric |
| WAR | numeric |
| WAROld | numeric |
| Dollars | numeric |
| BaseRunning | numeric |
| Spd | numeric |
| wRC_plus | numeric |
| wBsR | numeric |
| WPA | numeric |
| WPA_minus | numeric |
| WPA_plus | numeric |
| RE24 | numeric |
| REW | numeric |
| pLI | numeric |
| phLI | numeric |
| PH | integer |
| WPA_LI | numeric |
| Clutch | numeric |
| FBall_pct | numeric |
| FBv | numeric |
| SL_pct | numeric |
| SLv | numeric |
| CT_pct | numeric |
| CTv | numeric |
| CB_pct | numeric |
| CBv | numeric |
| CH_pct | numeric |
| CHv | numeric |
| SF_pct | numeric |
| SFv | numeric |
| KN_pct | numeric |
| KNv | numeric |
| XX_pct | numeric |
| wFB | numeric |
| wSL | numeric |
| wCT | numeric |
| wCB | numeric |
| wCH | numeric |
| wSF | numeric |
| wKN | numeric |
| wFB_C | numeric |
| wSL_C | numeric |
| wCT_C | numeric |
| wCB_C | numeric |
| wCH_C | numeric |
| wSF_C | numeric |
| wKN_C | numeric |
| O-Swing_pct | numeric |
| Z-Swing_pct | numeric |
| Swing_pct | numeric |
| O-Contact_pct | numeric |
| Z-Contact_pct | numeric |
| Contact_pct | numeric |
| Zone_pct | numeric |
| F-Strike_pct | numeric |
| SwStr_pct | numeric |
| CStr_pct | numeric |
| C+SwStr_pct | numeric |
| Pull | integer |
| Cent | integer |
| Oppo | integer |
| Soft | integer |
| Med | integer |
| Hard | integer |
| bipCount | integer |
| Pull_pct | numeric |
| Cent_pct | numeric |
| Oppo_pct | numeric |
| Soft_pct | numeric |
| Med_pct | numeric |
| Hard_pct | numeric |
| UBR | numeric |
| GDPRuns | numeric |
| AVG+ | numeric |
| BB_pct+ | numeric |
| K_pct+ | numeric |
| OBP+ | numeric |
| SLG+ | numeric |
| ISO+ | numeric |
| BABIP+ | numeric |
| LD_pct+ | numeric |
| GB_pct+ | numeric |
| FB_pct+ | numeric |
| HRFB_pct+ | numeric |
| Pull_pct+ | numeric |
| Cent_pct+ | numeric |
| Oppo_pct+ | numeric |
| Soft_pct+ | numeric |
| Med_pct+ | numeric |
| Hard_pct+ | numeric |
| rFTeamV | integer |
| rBTeamV | integer |
| rTV | integer |
| pfx_FA_pct | numeric |
| pfx_FT_pct | numeric |
| pfx_FC_pct | numeric |
| pfx_FS_pct | numeric |
| pfx_FO_pct | numeric |
| pfx_SI_pct | numeric |
| pfx_SL_pct | numeric |
| pfx_CU_pct | numeric |
| pfx_KC_pct | numeric |
| pfx_EP_pct | numeric |
| pfx_CH_pct | numeric |
| pfx_KN_pct | numeric |
| pfx_vFA | numeric |
| pfx_vFT | numeric |
| pfx_vFC | numeric |
| pfx_vFS | numeric |
| pfx_vFO | numeric |
| pfx_vSI | numeric |
| pfx_vSL | numeric |
| pfx_vCU | numeric |
| pfx_vKC | numeric |
| pfx_vEP | numeric |
| pfx_vCH | numeric |
| pfx_vKN | numeric |
| pfx_FA-X | numeric |
| pfx_FT-X | numeric |
| pfx_FC-X | numeric |
| pfx_FS-X | numeric |
| pfx_FO-X | numeric |
| pfx_SI-X | numeric |
| pfx_SL-X | numeric |
| pfx_CU-X | numeric |
| pfx_KC-X | numeric |
| pfx_EP-X | numeric |
| pfx_CH-X | numeric |
| pfx_KN-X | numeric |
| pfx_FA-Z | numeric |
| pfx_FT-Z | numeric |
| pfx_FC-Z | numeric |
| pfx_FS-Z | numeric |
| pfx_FO-Z | numeric |
| pfx_SI-Z | numeric |
| pfx_SL-Z | numeric |
| pfx_CU-Z | numeric |
| pfx_KC-Z | numeric |
| pfx_EP-Z | numeric |
| pfx_CH-Z | numeric |
| pfx_KN-Z | numeric |
| pfx_wFA | numeric |
| pfx_wFT | numeric |
| pfx_wFC | numeric |
| pfx_wFS | numeric |
| pfx_wFO | numeric |
| pfx_wSI | numeric |
| pfx_wSL | numeric |
| pfx_wCU | numeric |
| pfx_wKC | numeric |
| pfx_wEP | numeric |
| pfx_wCH | numeric |
| pfx_wKN | numeric |
| pfx_wFA_C | numeric |
| pfx_wFT_C | numeric |
| pfx_wFC_C | numeric |
| pfx_wFS_C | numeric |
| pfx_wFO_C | numeric |
| pfx_wSI_C | numeric |
| pfx_wSL_C | numeric |
| pfx_wCU_C | numeric |
| pfx_wKC_C | numeric |
| pfx_wEP_C | numeric |
| pfx_wCH_C | numeric |
| pfx_wKN_C | numeric |
| pfx_O-Swing_pct | numeric |
| pfx_Z-Swing_pct | numeric |
| pfx_Swing_pct | numeric |
| pfx_O-Contact_pct | numeric |
| pfx_Z-Contact_pct | numeric |
| pfx_Contact_pct | numeric |
| pfx_Zone_pct | numeric |
| pfx_Pace | numeric |
| pi_CH_pct | numeric |
| pi_CS_pct | numeric |
| pi_CU_pct | numeric |
| pi_FA_pct | numeric |
| pi_FC_pct | numeric |
| pi_FS_pct | numeric |
| pi_KN_pct | numeric |
| pi_SI_pct | numeric |
| pi_SL_pct | numeric |
| pi_XX_pct | numeric |
| pi_vCH | numeric |
| pi_vCS | numeric |
| pi_vCU | numeric |
| pi_vFA | numeric |
| pi_vFC | numeric |
| pi_vFS | numeric |
| pi_vKN | numeric |
| pi_vSI | numeric |
| pi_vSL | numeric |
| pi_vXX | numeric |
| pi_CH-X | numeric |
| pi_CS-X | numeric |
| pi_CU-X | numeric |
| pi_FA-X | numeric |
| pi_FC-X | numeric |
| pi_FS-X | numeric |
| pi_KN-X | numeric |
| pi_SI-X | numeric |
| pi_SL-X | numeric |
| pi_XX-X | numeric |
| pi_CH-Z | numeric |
| pi_CS-Z | numeric |
| pi_CU-Z | numeric |
| pi_FA-Z | numeric |
| pi_FC-Z | numeric |
| pi_FS-Z | numeric |
| pi_KN-Z | numeric |
| pi_SI-Z | numeric |
| pi_SL-Z | numeric |
| pi_XX-Z | numeric |
| pi_wCH | numeric |
| pi_wCS | numeric |
| pi_wCU | numeric |
| pi_wFA | numeric |
| pi_wFC | numeric |
| pi_wFS | numeric |
| pi_wKN | numeric |
| pi_wSI | numeric |
| pi_wSL | numeric |
| pi_wXX | numeric |
| pi_wCH_C | numeric |
| pi_wCS_C | numeric |
| pi_wCU_C | numeric |
| pi_wFA_C | numeric |
| pi_wFC_C | numeric |
| pi_wFS_C | numeric |
| pi_wKN_C | numeric |
| pi_wSI_C | numeric |
| pi_wSL_C | numeric |
| pi_wXX_C | numeric |
| pi_O-Swing_pct | numeric |
| pi_Z-Swing_pct | numeric |
| pi_Swing_pct | numeric |
| pi_O-Contact_pct | numeric |
| pi_Z-Contact_pct | numeric |
| pi_Contact_pct | numeric |
| pi_Zone_pct | numeric |
| pi_Pace | numeric |
| Events | integer |
| EV | numeric |
| LA | numeric |
| Barrels | integer |
| Barrel_pct | numeric |
| maxEV | numeric |
| HardHit | integer |
| HardHit_pct | numeric |
| Q | numeric |
| TG | integer |
| TPA | integer |
| team_name_abb | character |
| teamid | integer |
| Pos | numeric |
| pi_SB_pct | numeric |
| pi_vSB | numeric |
| pi_SB-X | numeric |
| pi_SB-Z | numeric |
| pi_wSB | numeric |
| pi_wSB_C | numeric |
| pfx_SC_pct | numeric |
| pfx_vSC | numeric |
| pfx_SC-X | numeric |
| pfx_SC-Z | numeric |
| pfx_wSC | numeric |
| pfx_wSC_C | numeric |
Examples
# \donttest{
try(fg_team_batter(startseason = 2015, endseason = 2015, qual = 200))
#> ── MLB Team Batting data from FanGraphs.com ───────── baseballr 1.6.0 ──
#> ℹ Data updated: 2024-04-13 21:55:10 UTC
#> # A tibble: 30 × 329
#> Season team_name SeasonMin SeasonMax G AB PA H `1B`
#> <int> <chr> <int> <int> <int> <int> <int> <int> <int>
#> 1 2015 TOR 2015 2015 2337 5509 6231 1480 923
#> 2 2015 SFG 2015 2015 2342 5565 6153 1486 1023
#> 3 2015 LAD 2015 2015 2379 5385 6090 1346 870
#> 4 2015 HOU 2015 2015 2333 5459 6073 1363 829
#> 5 2015 CHC 2015 2015 2406 5491 6200 1341 868
#> 6 2015 NYM 2015 2015 2325 5527 6145 1351 862
#> 7 2015 PIT 2015 2015 2431 5631 6285 1462 1003
#> 8 2015 STL 2015 2015 2406 5484 6139 1386 922
#> 9 2015 KCR 2015 2015 2263 5575 6116 1497 1016
#> 10 2015 TEX 2015 2015 2358 5511 6187 1419 936
#> # ℹ 20 more rows
#> # ℹ 320 more variables: `2B` <int>, `3B` <int>, HR <int>, R <int>,
#> # RBI <int>, BB <int>, IBB <int>, SO <int>, HBP <int>, SF <int>,
#> # SH <int>, GDP <int>, SB <int>, CS <int>, AVG <dbl>, GB <int>,
#> # FB <int>, LD <int>, IFFB <int>, Pitches <int>, Balls <int>,
#> # Strikes <int>, IFH <int>, BU <int>, BUH <int>, BB_pct <dbl>,
#> # K_pct <dbl>, BB_K <dbl>, OBP <dbl>, SLG <dbl>, OPS <dbl>, …
# }