A simple API which allows you to grab the Billboard #1 song(s) for any date (since 1959).
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
public
views
.glitch-assets
README.md
package.json
server.js

README.md

Billboard Top 100 API

This is a simple API which allows you to grab the Billboard #1 song(s) for any date (since 1959).

API Usage

// Get a list of all #1 songs in a given year
GET /:year

// Returns:
[
  {
    "name": "Name of hit song",
    "artist": "Name of Artist",
    "startDate": "(first day on chart, in UTC)",
    "endDate": "(last day on chart, in UTC)"
  },
  ...
]

Example (GET /1969)


// Get a list of all #1 songs in a given month
GET /:year/:month

// Returns:
[
  {
    "name": "Name of hit song",
    "artist": "Name of Artist"
  },
  ...
]

Example (GET /1969/Feb)


// Get the #1 song for a given day
GET /:year/:month/:day

// Returns:
{
  "name": "Name of hit song",
  "artist": "Name of Artist",
  "startDate": "(first day on chart, in UTC)",
  "endDate": "(last day on chart, in UTC)"
}

Example (GET /1969/Feb/14)