# taylor [](https://www.repostatus.org/#active) [](https://lifecycle.r-lib.org/articles/stages.html) [](https://CRAN.R-project.org/package=taylor) [](https://cran.r-project.org/package=measr)
[](https://github.com/wjakethompson/taylor/actions/workflows/R-CMD-check.yaml) [](https://app.codecov.io/gh/wjakethompson/taylor) [](https://app.netlify.com/sites/r-taylor/deploys)
[](https://keybase.io/wjakethompson)  ## Overview The goal of taylor is to provide easy access to a curated data set of Taylor Swift songs, including lyrics and audio characteristics. Data comes [Genius](https://genius.com/artists/Taylor-swift) and the [Spotify API](https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02).

## Installation You can install the released version of taylor from [CRAN](https://cran.r-project.org/) with: ``` r install.packages("taylor") ``` To install the development version from [GitHub](https://github.com/) use: ``` r # install.packages("remotes") remotes::install_github("wjakethompson/taylor") ``` ## Example There are three main data sets. The first is `taylor_album_songs`, which includes lyrics and audio features from the Spotify API for all songs on Taylor’s official studio albums. Notably this excludes singles released separately from an album (e.g., *Only the Young*, *Christmas Tree Farm*, etc.), and non-Taylor-owned albums that have a Taylor-owned alternative (e.g., *Fearless* is excluded in favor of *Fearless (Taylor’s Version)*). We support artists owning their work. ``` r taylor_album_songs #> # A tibble: 240 × 29 #> album_name ep album_release track_number track_name artist featuring #> #> 1 Taylor Swift FALSE 2006-10-24 1 Tim McGraw Taylo… #> 2 Taylor Swift FALSE 2006-10-24 2 Picture To Bu… Taylo… #> 3 Taylor Swift FALSE 2006-10-24 3 Teardrops On … Taylo… #> 4 Taylor Swift FALSE 2006-10-24 4 A Place In Th… Taylo… #> 5 Taylor Swift FALSE 2006-10-24 5 Cold As You Taylo… #> 6 Taylor Swift FALSE 2006-10-24 6 The Outside Taylo… #> 7 Taylor Swift FALSE 2006-10-24 7 Tied Together… Taylo… #> 8 Taylor Swift FALSE 2006-10-24 8 Stay Beautiful Taylo… #> 9 Taylor Swift FALSE 2006-10-24 9 Should've Sai… Taylo… #> 10 Taylor Swift FALSE 2006-10-24 10 Mary's Song (… Taylo… #> # ℹ 230 more rows #> # ℹ 22 more variables: bonus_track , promotional_release , #> # single_release , track_release , danceability , #> # energy , key , loudness , mode , speechiness , #> # acousticness , instrumentalness , liveness , valence , #> # tempo , time_signature , duration_ms , explicit , #> # key_name , mode_name , key_mode , lyrics ``` You can access Taylor’s entire discography with `taylor_all_songs`. This includes all of the songs in `taylor_album_songs` plus EPs, individual singles, and the original versions of albums that have been re-released as *Taylor’s Version*. ``` r taylor_all_songs #> # A tibble: 364 × 29 #> album_name ep album_release track_number track_name artist featuring #> #> 1 Taylor Swift FALSE 2006-10-24 1 Tim McGraw Taylo… #> 2 Taylor Swift FALSE 2006-10-24 2 Picture To Bu… Taylo… #> 3 Taylor Swift FALSE 2006-10-24 3 Teardrops On … Taylo… #> 4 Taylor Swift FALSE 2006-10-24 4 A Place In Th… Taylo… #> 5 Taylor Swift FALSE 2006-10-24 5 Cold As You Taylo… #> 6 Taylor Swift FALSE 2006-10-24 6 The Outside Taylo… #> 7 Taylor Swift FALSE 2006-10-24 7 Tied Together… Taylo… #> 8 Taylor Swift FALSE 2006-10-24 8 Stay Beautiful Taylo… #> 9 Taylor Swift FALSE 2006-10-24 9 Should've Sai… Taylo… #> 10 Taylor Swift FALSE 2006-10-24 10 Mary's Song (… Taylo… #> # ℹ 354 more rows #> # ℹ 22 more variables: bonus_track , promotional_release , #> # single_release , track_release , danceability , #> # energy , key , loudness , mode , speechiness , #> # acousticness , instrumentalness , liveness , valence , #> # tempo , time_signature , duration_ms , explicit , #> # key_name , mode_name , key_mode , lyrics ``` Finally, there is a small data set, `taylor_albums`, summarizing Taylor’s album release history. ``` r taylor_albums #> # A tibble: 17 × 5 #> album_name ep album_release metacritic_score user_score #> #> 1 Taylor Swift FALSE 2006-10-24 67 8.4 #> 2 The Taylor Swift Holiday Col… TRUE 2007-10-14 NA NA #> 3 Beautiful Eyes TRUE 2008-07-15 NA NA #> 4 Fearless FALSE 2008-11-11 73 8.4 #> 5 Speak Now FALSE 2010-10-25 77 8.6 #> 6 Red FALSE 2012-10-22 77 8.6 #> 7 1989 FALSE 2014-10-27 76 8.3 #> 8 reputation FALSE 2017-11-10 71 8.3 #> 9 Lover FALSE 2019-08-23 79 8.4 #> 10 folklore FALSE 2020-07-24 88 9 #> 11 evermore FALSE 2020-12-11 85 8.9 #> 12 Fearless (Taylor's Version) FALSE 2021-04-09 82 8.9 #> 13 Red (Taylor's Version) FALSE 2021-11-12 91 8.9 #> 14 Midnights FALSE 2022-10-21 85 8.3 #> 15 Speak Now (Taylor's Version) FALSE 2023-07-07 81 9.2 #> 16 1989 (Taylor's Version) FALSE 2023-10-27 90 NA #> 17 THE TORTURED POETS DEPARTMENT FALSE 2024-04-19 76 NA ``` ## Code of Conduct Contributions are welcome. To ensure a smooth process, please review the [Contributing Guide](https://taylor.wjakethompson.com/CONTRIBUTING.html). Please note that the taylor project is released with a [Contributor Code of Conduct](https://taylor.wjakethompson.com/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.