josiahparry/bbcharts

Access billboard charts. Not on CRAN quite yet.

bbcharts

bbcharts provides an interface to the Billboards top charts. There is functionality for accessing weekly charts, annual charts, and the decade end data is exported as an object bbcharts::decade_end.

Installation

You can install the latest version of bbcharts from GitHub with:

remotes::install_github("josiahparry/bbcharts")

Decade End Charts

count(bbcharts::decade_end, artist, sort = TRUE)

Year End Charts

View all possible year end charts with ye_chart_table

bbcharts::ye_chart_table

Identify which chart you would like then pass along that chart_url to year_end_bb() and the year you would like it for. Due to slight inconsistencies between charts, i.e. album, artist, and song charts, the artist and title fields may be swapped around.

year_end_bb("hot-100-songs", 1960)

Weekly Charts

You can retrieve weekly charts in a very similar manner as the yearly charts. To view the weekly charts use bbcharts::chart_table

chart_table

Provide the name of the chart you want and the week you want it for in yyyy-mm-dd format.

bb_chart("hot-100", "2017-12-10")

{bbcharts} + {genius}

Use bbcharts in conjunction with genius to get the lyrics for songs on the top charts.

library(dplyr)
library(genius)
alt <- bb_chart("alternative-songs")

alt_lyrics <- alt %>% 
  # get only the first 5 songs
  slice(1:5) %>% 
  # add lyrics to a data frame
  add_genius(artist, title, type = "lyrics")

alt_lyrics

List possible charts

You can view all possible charts to query from using the chart_table that is exported.

bbcharts::chart_table

Artist Specific Chart Data

There are a number of functions that provide Billboard chart data for a specific artist.

Listing artist charts

It is possible to list all of the charts that a given artist appears on using list_artist_charts().

list_artist_charts("Andrew Bird")

Artist songs on a specific chart

Using the information above we can list all of the songs on a chart from a given artist using get_artist_chart_history(). In this case we will look at Triple A Songs (adult alternative).

get_artist_chart_history("Andrew Bird", "triple-a")

All chart information for a given artist

We can use the add_chart_history() function in conjunction with list_artist_charts() to get all chart history for an artist.

list_artist_charts("Andrew Bird") %>% 
  add_chart_history(artist = artist, chart_url = chart_url)

You can also do this for any mix of artists.

tribble(
  ~artist, ~chart,
  "Andrew Bird", "triple-a",
  "Taylor Swift", "hot-100"
) %>% 
  add_chart_history(artist, chart)

bbcharts's Issues

more flexible identification of featured artists

when there are multiple artists billboard will sometimes write "featuring", "X", "&" and these need to be split on. But this can be problematic.

charts reset on saturday and no data on sunday, breaks bb_chart

Today is Sunday, 2019-06-16. If you call bb_chart() for this week, there is no data and causes bb_chart to error out.

convert from html_session to read_html for speed improvements

create year-end bb_chart function

Year end charts are different.

https://www.billboard.com/charts/year-end/