taylor

February 13, 2026 · View on GitHub

Project Status: Active – The project has reached a stable, usable state and is being actively developed. lifecycle R package version Package downloads
R-CMD-check codecov Netlify Status
Signed by License

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 from Genius and the SoundStat API.

GIF of Taylor saying “yes”

Installation

You can install the released version of taylor from CRAN with:

install.packages("taylor")

To install the development version from GitHub use:

# 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 SoundStat 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 EPs (e.g., Beautiful Eyes). However, now that Taylor owns all her masters, both the original and Taylor’s Version are included for albums that were rerecorded (e.g., both Fearless and Fearless (Taylor’s Version) are present).

$ \text{r} \text{taylor\_album\_songs} #> # \text{A} \text{tibble}: 332 \times 26 #> \text{album\_name} \text{ep} \text{album\_release} \text{track\_number} \text{track\_name} \text{artist} \text{featuring} #> <\text{chr}> <\text{lgl}> <\text{date}> <\text{int}> <\text{chr}> <\text{chr}> <\text{chr}> #> 1 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 1 \text{Tim} \text{McGraw} \text{Taylo}… <\text{NA}> #> 2 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 2 \text{Picture} \text{To} \text{Bu}… \text{Taylo}… <\text{NA}> #> 3 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 3 \text{Teardrops} \text{On} … \text{Taylo}… <\text{NA}> #> 4 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 4 \text{A} \text{Place} \text{In} \text{Th}… \text{Taylo}… <\text{NA}> #> 5 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 5 \text{Cold} \text{As} \text{You} \text{Taylo}… <\text{NA}> #> 6 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 6 \text{The} \text{Outside} \text{Taylo}… <\text{NA}> #> 7 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 7 \text{Tied} \text{Together}… \text{Taylo}… <\text{NA}> #> 8 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 8 \text{Stay} \text{Beautiful} \text{Taylo}… <\text{NA}> #> 9 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 9 \text{Should}'\text{ve} \text{Sai}… \text{Taylo}… <\text{NA}> #> 10 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 10 \text{Mary}'\text{s} \text{Song} (… \text{Taylo}… <\text{NA}> #> # ℹ 322 \text{more} \text{rows} #> # ℹ 19 \text{more} \text{variables}: \text{bonus\_track} <\text{lgl}>, \text{promotional\_release} <\text{date}>, #> # \text{single\_release} <\text{date}>, \text{track\_release} <\text{date}>, \text{danceability} <\text{dbl}>, #> # \text{energy} <\text{dbl}>, \text{loudness} <\text{dbl}>, \text{acousticness} <\text{dbl}>, \text{instrumentalness} <\text{dbl}>, #> # \text{valence} <\text{dbl}>, \text{tempo} <\text{dbl}>, \text{duration\_ms} <\text{int}>, \text{explicit} <\text{lgl}>, \text{key} <\text{int}>, #> # \text{mode} <\text{int}>, \text{key\_name} <\text{chr}>, \text{mode\_name} <\text{chr}>, \text{key\_mode} <\text{chr}>, \text{lyrics} <\text{list}> $

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 songs where Taylor is credited as a featured artist or writer.

$ \text{r} \text{taylor\_all\_songs} #> # \text{A} \text{tibble}: 384 \times 26 #> \text{album\_name} \text{ep} \text{album\_release} \text{track\_number} \text{track\_name} \text{artist} \text{featuring} #> <\text{chr}> <\text{lgl}> <\text{date}> <\text{int}> <\text{chr}> <\text{chr}> <\text{chr}> #> 1 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 1 \text{Tim} \text{McGraw} \text{Taylo}… <\text{NA}> #> 2 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 2 \text{Picture} \text{To} \text{Bu}… \text{Taylo}… <\text{NA}> #> 3 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 3 \text{Teardrops} \text{On} … \text{Taylo}… <\text{NA}> #> 4 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 4 \text{A} \text{Place} \text{In} \text{Th}… \text{Taylo}… <\text{NA}> #> 5 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 5 \text{Cold} \text{As} \text{You} \text{Taylo}… <\text{NA}> #> 6 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 6 \text{The} \text{Outside} \text{Taylo}… <\text{NA}> #> 7 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 7 \text{Tied} \text{Together}… \text{Taylo}… <\text{NA}> #> 8 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 8 \text{Stay} \text{Beautiful} \text{Taylo}… <\text{NA}> #> 9 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 9 \text{Should}'\text{ve} \text{Sai}… \text{Taylo}… <\text{NA}> #> 10 \text{Taylor} \text{Swift} \text{FALSE} 2006-10-24 10 \text{Mary}'\text{s} \text{Song} (… \text{Taylo}… <\text{NA}> #> # ℹ 374 \text{more} \text{rows} #> # ℹ 19 \text{more} \text{variables}: \text{bonus\_track} <\text{lgl}>, \text{promotional\_release} <\text{date}>, #> # \text{single\_release} <\text{date}>, \text{track\_release} <\text{date}>, \text{danceability} <\text{dbl}>, #> # \text{energy} <\text{dbl}>, \text{loudness} <\text{dbl}>, \text{acousticness} <\text{dbl}>, \text{instrumentalness} <\text{dbl}>, #> # \text{valence} <\text{dbl}>, \text{tempo} <\text{dbl}>, \text{duration\_ms} <\text{int}>, \text{explicit} <\text{lgl}>, \text{key} <\text{int}>, #> # \text{mode} <\text{int}>, \text{key\_name} <\text{chr}>, \text{mode\_name} <\text{chr}>, \text{key\_mode} <\text{chr}>, \text{lyrics} <\text{list}> $

Finally, there is a small data set, taylor_albums, summarizing Taylor’s album release history.

taylor_albums
#> # A tibble: 18 × 5
#>    album_name                    ep    album_release metacritic_score user_score
#>    <chr>                         <lgl> <date>                   <int>      <dbl>
#>  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  
#> 18 The Life of a Showgirl        FALSE 2025-10-03                  69       NA

Code of Conduct

Contributions are welcome. To ensure a smooth process, please review the Contributing Guide. Please note that the taylor project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.