Skip to content

Billboard API

Billboard (billboard.com) has 2 public methods: get chart and get an artist's chart history. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

billboard.com (opens in a new tab)

Unofficial. Not affiliated with or endorsed by Billboard.

Methods

2

  • Get chart

    Gets the ranked entries and chart history for a Billboard chart. It returns the latest published week, or the week that contains a given date. A date between published weeks selects the next published week.

    Returns chart name, chart week date, entries with rank, title, artist, last week rank, peak position, weeks on chart, status

    Readbillboard.com/get_chart

  • Get an artist's chart history

    Returns an artist's Billboard Hot 100 song history or Billboard 200 album history: chart totals (entries, No. 1 hits, top 10 hits) and each title's debut, peak and weeks on chart, most recent debut first.

    Returns artist, artist link, total chart entries, number one hits, top 10 hits, entries with title, peak position and date, debut date, weeks on chart, chart link

    Readbillboard.com/get_artist_chart_history