The fflr package is used to query the ESPN Fantasy Football API. Get data on fantasy football league members, teams, and individual athletes.
This package has been tested with a narrow subset of possible league settings. If a function doesn’t work as intended, please file an issue on GitHub.
Installation
You can install the release version of fflr from CRAN:
install.packages("fflr")The most recent development version can be installed from GitHub:
# install.packages("remotes")
remotes::install_github("k5cents/fflr")Usage
library(fflr)
packageVersion("fflr")
#> [1] '2.2.3'Data is only available for public leagues. See this help page on how to make a private league public
Functions require a unique leagueId, which can be found in any ESPN page URL.
https://fantasy.espn.com/football/league?leagueId=42654852
Use ffl_id() to set a default fflr.leagueId option. Your .Rprofile file can set this option on startup.
ffl_id(leagueId = "42654852")
#> Temporarily set `fflr.leagueId` option to 42654852
#> [1] "42654852"The leagueId argument defaults to ffl_id() and can be omitted once set.
league_info()
#> # A tibble: 1 × 6
#> id seasonId name isPublic size finalScoringPeriod
#> <int> <int> <chr> <lgl> <int> <int>
#> 1 42654852 2023 FFLR Test League TRUE 4 17
league_teams()
#> # A tibble: 4 × 6
#> teamId abbrev name logo logoType memberId
#> <int> <fct> <chr> <chr> <chr> <chr>
#> 1 1 AUS Austin Astronauts https://g.espncdn.com/lm-static/logo-packs/cor… VECTOR {22DFE7…
#> 2 2 BOS Boston Buzzards https://g.espncdn.com/lm-static/logo-packs/cor… VECTOR {22DFE7…
#> 3 3 CHI Chicago Crowns https://g.espncdn.com/lm-static/logo-packs/cor… VECTOR {22DFE7…
#> 4 4 DEN Denver Devils https://g.espncdn.com/lm-static/logo-packs/cor… VECTOR {22DFE7…The scoringPeriodId argument can be used to get data from past weeks.
all_rost <- team_roster(scoringPeriodId = 1)
all_rost$CHI[, 5:13][-7]
#> # A tibble: 16 × 8
#> lineupSlot playerId firstName lastName proTeam position projectedScore actualScore
#> <fct> <int> <chr> <chr> <fct> <fct> <dbl> <dbl>
#> 1 QB 4040715 Jalen Hurts Phi QB 21.3 12.5
#> 2 RB 3929630 Saquon Barkley NYG RB 16.9 9.3
#> 3 RB 4239996 Travis Etienne Jr. Jax RB 15.1 21.4
#> 4 WR 4262921 Justin Jefferson Min WR 20.1 24
#> 5 WR 4569618 Garrett Wilson NYJ WR 16.4 14.4
#> 6 TE 15847 Travis Kelce KC TE 0 0
#> 7 FLEX 4374302 Amon-Ra St. Brown Det WR 16.7 19.1
#> 8 D/ST -16025 49ers D/ST SF D/ST 7.78 14
#> 9 K 3055899 Harrison Butker KC K 8.41 8
#> 10 BE 4429795 Jahmyr Gibbs Det RB 14.0 8
#> 11 BE 3042519 Aaron Jones GB RB 15.5 26.7
#> 12 BE 3915511 Joe Burrow Cin QB 19.8 3.18
#> 13 BE 2976499 Amari Cooper Cle WR 13.6 6.7
#> 14 BE 4697815 Rachaad White TB RB 13.9 6.9
#> 15 BE 3054850 Alvin Kamara NO RB 0 0
#> 16 BE 4038941 Justin Herbert LAC QB 16.9 20.9There are included objects for NFL teams and players.
nfl_teams
#> # A tibble: 33 × 6
#> proTeamId abbrev location name byeWeek conference
#> <int> <fct> <chr> <chr> <int> <chr>
#> 1 0 FA <NA> Free Agent NA <NA>
#> 2 1 Atl Atlanta Falcons 14 NFC
#> 3 2 Buf Buffalo Bills 7 AFC
#> 4 3 Chi Chicago Bears 14 NFC
#> 5 4 Cin Cincinnati Bengals 10 AFC
#> 6 5 Cle Cleveland Browns 9 AFC
#> 7 6 Dal Dallas Cowboys 9 NFC
#> 8 7 Den Denver Broncos 9 AFC
#> 9 8 Det Detroit Lions 6 NFC
#> 10 9 GB Green Bay Packers 14 NFC
#> # ℹ 23 more rowsThe fflr project is released with a Contributor Code of Conduct. By contributing, you agree to abide by its terms.
