Skip to content

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

Notifications You must be signed in to change notification settings

jaydenwindle/billboard100api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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)


About

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

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published