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.
You can install the release version of fflr from CRAN:
The most recent development version can be installed from GitHub:
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 2021 FFLR Test League TRUE 4 17
league_teams()
#> # A tibble: 4 × 5
#> abbrev teamId location nickname memberId
#> <fct> <int> <chr> <chr> <chr>
#> 1 AUS 1 Austin Astronauts {22DFE7FF-9DF2-4F3B-9FE7-FF9DF2AF3BD2}
#> 2 BOS 2 Boston Buzzards {22DFE7FF-9DF2-4F3B-9FE7-FF9DF2AF3BD2}
#> 3 CHI 3 Chicago Crowns {22DFE7FF-9DF2-4F3B-9FE7-FF9DF2AF3BD2}
#> 4 DEN 4 Denver Devils {22DFE7FF-9DF2-4F3B-9FE7-FF9DF2AF3BD2}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 3918298 Josh Allen Buf QB 21.6 17.2
#> 2 RB 3929630 Saquon Barkley NYG RB 13.8 3.7
#> 3 RB 3043078 Derrick Henry Ten RB 17.3 10.7
#> 4 WR 15795 DeAndre Hopkins Ari WR 17.8 26.3
#> 5 WR 4262921 Justin Jefferson Min WR 15.4 12.5
#> 6 TE 2576925 Darren Waller LV TE 14.2 26.5
#> 7 FLEX 3068267 Austin Ekeler LAC RB 15.0 11.7
#> 8 D/ST -16033 Ravens D/ST Bal D/ST 5.86 -1
#> 9 K 15683 Justin Tucker Bal K 8.14 11
#> 10 BE 3116385 Joe Mixon Cin RB 14.6 25
#> 11 BE 15818 Keenan Allen LAC WR 14.8 19
#> 12 BE 16737 Mike Evans TB WR 15.0 5.4
#> 13 BE 4047365 Josh Jacobs LV RB 13.1 17
#> 14 BE 3886818 Myles Gaskin Mia RB 10.9 12.6
#> 15 BE 4362628 Ja'Marr Chase Cin WR 10.4 20.9
#> 16 BE 4360438 Brandon Aiyuk SF WR 13.9 0There 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> FA 0 <NA>
#> 2 1 Atl Atlanta Falcons 6 NFC
#> 3 2 Buf Buffalo Bills 7 AFC
#> 4 3 Chi Chicago Bears 10 NFC
#> 5 4 Cin Cincinnati Bengals 10 AFC
#> 6 5 Cle Cleveland Browns 13 AFC
#> 7 6 Dal Dallas Cowboys 7 NFC
#> 8 7 Den Denver Broncos 11 AFC
#> 9 8 Det Detroit Lions 9 NFC
#> 10 9 GB Green Bay Packers 13 NFC
#> # … with 23 more rowsThe fflr project is released with a Contributor Code of Conduct. By contributing, you agree to abide by its terms.