mhollingshead / billboard-hot-100

JSON files for every Billboard Hot 100 chart in history, updated daily.

Historic Billboard Hot 100 Data

JSON files for every Billboard Hot 100 chart in history, updated daily.

1958-08-04 | 2023-11-25

Get the Most Recent Chart

To get the current Billboard Hot 100 chart, use the following URL:

https://raw.githubusercontent.com/mhollingshead/billboard-hot-100/main/recent.json

The JSON data will be a single chart object.

Get a Specific Chart

To get the Billboard Hot 100 chart during a specific week, use the following URL:

https://raw.githubusercontent.com/mhollingshead/billboard-hot-100/main/date/<DATE>.json

where <DATE> is a valid release date (formatted YYYY-MM-DD). The JSON data will be a single chart object.

Valid Release Dates

You can use valid_dates.json to get a list of all valid release dates.

Get All Charts

To get all Billboard Hot 100 charts, use the following URL:

https://raw.githubusercontent.com/mhollingshead/billboard-hot-100/main/all.json

The JSON data will be an array of chart objects.

Schema

All JSON files contain either single chart objects or arrays of chart objects.

Chart Object

{
    "date": String,
    "data": [
        {
            "song": String,
            "artist": String,
            "this_week": Number,
            "last_week": Number || null,
            "peak_position": Number,
            "weeks_on_chart": Number
        },
        ...
    ]
}

Attribute	Type	Description
date	String	The chart's release date (formatted YYYY-MM-DD).
data	Array<Object>	The chart's data, an array of 100 song objects.
song object.song	String	The song's title.
song object.artist	String	The song's artist.
song object.this_week	Number	The song's current chart position.
song object.last_week	Number | null	The song's chart position during the previous week.
song object.peak_position	Number	The song's peak chart position during any week.
song object.weeks_on_chart	Number	The number of weeks that the song has been on the chart.