An R Client for Fantasy Football League APIs
Helps access various Fantasy Football APIs (currently MFL, Sleeper,
Fleaflicker, and ESPN - perhaps eventually Yahoo and others) by handling
authentication/rate-limiting/caching, forming appropriate calls, and
returning tidy dataframes which can be easily connected to other data
sources.
Installation
Install the stable version of this package from CRAN:
install.packages("ffscrapr")
Install the development version from either
r-universe or GitHub:
install.packages("ffscrapr", repos = c("https://ffverse.r-universe.dev", getOption("repos")))
# pak is recommended, see https://github.com/r-lib/pak
pak::pak("ffverse/ffscrapr")
# can also use remotes
remotes::install_github("ffverse/ffscrapr")
Usage
All ffscrapr functions start with a connection object created by
ff_connect(), which stores connection, authentication, and other
user-defined parameters. This object is used by all other functions to
help return the correct data.
library(ffscrapr)
ssb <- ff_connect(platform = "mfl", league_id = "54040", season = 2020)
# Get a summary of league settings
ff_league(ssb) %>% str()
#> tibble [1 × 17] (S3: tbl_df/tbl/data.frame)
#> $ league_id : chr "54040"
#> $ league_name : chr "The Super Smash Bros Dynasty League"
#> $ season : int 2020
#> $ league_type : chr NA
#> $ franchise_count : num 14
#> $ qb_type : chr "1QB"
#> $ idp : logi FALSE
#> $ scoring_flags : chr "0.5_ppr, TEPrem, PP1D"
#> $ best_ball : logi FALSE
#> $ salary_cap : logi FALSE
#> $ player_copies : num 1
#> $ years_active : chr "2018-2021"
#> $ qb_count : chr "1"
#> $ roster_size : num 33
#> $ league_depth : num 462
#> $ draft_type : chr " email draft"
#> $ draft_player_pool: chr "Both"
# Get rosters
ff_rosters(ssb)
#> # A tibble: 417 × 11
#> franchise_id franchise_name player_id player_name pos team age
#> <chr> <chr> <chr> <chr> <chr> <chr> <dbl>
#> 1 0001 Team Pikachu 13189 Engram, Evan TE NYG 28.4
#> 2 0001 Team Pikachu 11680 Landry, Jarvis WR CLE 30.2
#> 3 0001 Team Pikachu 13645 Smith, Tre'Quan WR NOS 27.1
#> 4 0001 Team Pikachu 12110 Brate, Cameron TE TBB 31.6
#> 5 0001 Team Pikachu 13168 Reynolds, Josh WR LAR 28
#> # … with 412 more rows, and 4 more variables: roster_status <chr>,
#> # drafted <chr>, draft_year <chr>, draft_round <chr>
#> # ℹ Use `print(n = ...)` to see more rows, and `colnames()` to see all variable names
# Get transactions
ff_transactions(ssb)
#> # A tibble: 1,145 × 12
#> timestamp type type_desc franchise_id franchise_name
#> <dttm> <chr> <chr> <chr> <chr>
#> 1 2021-02-12 14:32:39 TRADE traded_away 0008 Team Bowser
#> 2 2021-02-12 14:32:39 TRADE traded_for 0008 Team Bowser
#> 3 2021-02-12 14:32:39 TRADE traded_for 0008 Team Bowser
#> 4 2021-02-12 14:32:39 TRADE traded_for 0008 Team Bowser
#> 5 2021-02-12 14:32:39 TRADE traded_for 0008 Team Bowser
#> # … with 1,140 more rows, and 7 more variables: player_id <chr>,
#> # player_name <chr>, pos <chr>, team <chr>, bbid_spent <dbl>,
#> # trade_partner <chr>, comments <chr>
#> # ℹ Use `print(n = ...)` to see more rows, and `colnames()` to see all variable names
Platform-specific guides on getting started with ffscrapr are here:
There are also some more advanced guides for custom API calls in the
Articles section, as well as
some guides on optimizing ffscrapr’s
performance.
Support
The best places to get help on this package are:
Contributing
Many hands make light work! Here are some ways you can contribute to
this project:
Terms of Use
The R code for this package is released as open source under the MIT
license.
The APIs and data accessed by this package belong to their respective
owners, and are governed by their terms of use.
评论