/billboard100api

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

Primary LanguageJavaScript

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)