fg_team_batter {baseballr}

Scrape Team Batter Leaderboards from FanGraphs

Description

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

  try(fg_team_batter(startseason = 2015, endseason = 2015, qual = 200))