Billboard

Chart rankings, song chart history and album chart history

Billboard provides chart rankings and histories for published chart weeks, including artists’ Hot 100 song and Billboard 200 album totals and title-by-title performance.

Get artist chart history

Get an artist’s Billboard Hot 100 song history or Billboard 200 album history, including chart totals and each title’s debut, peak and weeks on chart. Results are ordered by most recent debut.

Your information

ChartOptional

Select the Billboard chart, for example “Hot 100”.

Artist

Artist name, for example Taylor Swift.

Max ResultsOptional

Maximum titles returned, for example 100.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Chart totals for Adele

Chart entries6

Top 10 hits4

No. 1 hits3

View Adele on Billboard

Titles

About the Billboard tool

Get chart returns ranked entries for a chart and week; provide a chart name, with date and result count optional.

Get artist chart history returns an artist’s Hot 100 song or Billboard 200 album history; provide an artist and chart.

Built from billboard.com. Last checked Sep 30, 2026.

Actions

Get artist chart history

1 credit

Get an artist’s Billboard Hot 100 song history or Billboard 200 album history, including chart totals and each title’s debut, peak and weeks on chart. Results are ordered by most recent debut.

What you provide

Field	Type	Required	Description
Chart`chart`	Text	Optional	Select the Billboard chart, for example hot_100.Example: Billboard 200
Artist`artist`	Text	Required	Artist name, for example Taylor Swift.Example: Adele
Max Results`max_results`	Number	Optional	Maximum titles returned, for example 100.Example: 3

What you get

Field	Type	Description
Artist`artist`	Text	Example: Adele
Entries`entries`	List
Title`entries[].title`	Text	Example: 30
Page Link`entries[].page_link`	Text	Example: https://www.billboard.com/charts/billboard-200/2021-12-04/
Peak Date`entries[].peak_date`	Date	Example: 2021-12-04
Debut Date`entries[].debut_date`	Date	Example: 2021-12-04
Peak Position`entries[].peak_position`	Number	Example: 1
Weeks On Chart`entries[].weeks_on_chart`	Number	Example: 69
Artist Link`artist_link`	Text	Example: https://www.billboard.com/artist/adele/
Top 10 Hits`top_10_hits`	Number	Example: 4
Number One Hits`number_one_hits`	Number	Example: 3
Total Chart Entries`total_chart_entries`	Number	Example: 6

Example result

For Chart: Billboard 200, Artist: Adele, Max Results: 3

JSON

{
  "artist": "Adele",
  "entries": [
    {
      "title": "30",
      "page_link": "https://www.billboard.com/charts/billboard-200/2021-12-04/",
      "peak_date": "2021-12-04",
      "debut_date": "2021-12-04",
      "peak_position": 1,
      "weeks_on_chart": 69
    },
    {
      "title": "25",
      "page_link": "https://www.billboard.com/charts/billboard-200/2015-12-12/",
      "peak_date": "2015-12-12",
      "debut_date": "2015-12-12",
      "peak_position": 1,
      "weeks_on_chart": 223
    },
    {
      "title": "iTunes Festival: London 2011 (EP)",
      "page_link": "https://www.billboard.com/charts/billboard-200/2011-07-30/",
      "peak_date": "2011-08-06",
      "debut_date": "2011-07-30",
      "peak_position": 50,
      "weeks_on_chart": 2
    }
  ],
  "artist_link": "https://www.billboard.com/artist/adele/",
  "top_10_hits": 4,
  "number_one_hits": 3,
  "total_chart_entries": 6
}

Get chart

1 credit

Get the ranked entries and chart history for a Billboard chart in its latest or a past chart week. Dates between published weeks select the next published week; weeks not yet published are unavailable.

What you provide

Field	Type	Required	Description
Date`date`	Date	Optional	Day in the chart week, for example 2024-04-03. Omit for the latest published week.Example: 2024-04-03
Chart`chart`	Text	Required	Chart name as people say it, for example Hot 100, Billboard 200, Global 200, Artist 100, or Hot Country Songs.Example: Hot 100
Max Results`max_results`	Number	Optional	Maximum number of ranked entries, for example 10. Default 0 returns the full chart.Example: 10

What you get

Field	Type	Description
Entries`entries`	List
Rank`entries[].rank`	Number	Example: 1
Title`entries[].title`	Text	Example: Choosin' Texas
Artist`entries[].artist`	Text	Example: Ella Langley
Status`entries[].status`	Text	Example: New
Page URL`entries[].page_url`	Text	Example: https://www.billboard.com/charts/hot-100/2026-09-26/
Peak Position`entries[].peak_position`	Number	Example: 1
Last Week Rank`entries[].last_week_rank`	Number	Example: 1
Weeks On Chart`entries[].weeks_on_chart`	Number	Example: 48
Chart Name`chart_name`	Text	Example: Billboard Hot 100
Chart Week Date`chart_week_date`	Date	Example: 2026-09-26

Example result

For Chart: Hot 100

JSON

{
  "entries": [
    {
      "rank": 1,
      "title": "Choosin' Texas",
      "artist": "Ella Langley",
      "status": null,
      "page_url": "https://www.billboard.com/charts/hot-100/2026-09-26/",
      "peak_position": 1,
      "last_week_rank": 1,
      "weeks_on_chart": 48
    },
    {
      "rank": 2,
      "title": "Boston",
      "artist": "Stella Lefty",
      "status": null,
      "page_url": "https://www.billboard.com/charts/hot-100/2026-09-26/",
      "peak_position": 2,
      "last_week_rank": 2,
      "weeks_on_chart": 24
    },
    {
      "rank": 3,
      "title": "Been By Now",
      "artist": "Morgan Wallen",
      "status": null,
      "page_url": "https://www.billboard.com/charts/hot-100/2026-09-26/",
      "peak_position": 2,
      "last_week_rank": 4,
      "weeks_on_chart": 8
    }
  ],
  "chart_name": "Billboard Hot 100",
  "chart_week_date": "2026-09-26"
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@billboard",
  "visibility": "public",
  "operation": "get_artist_chart_history",
  "version": 1,
  "input": {
    "chart": "billboard_200",
    "artist": "Adele",
    "max_results": 3
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Track chart positions across published weeks
Compare an artist’s chart entries and peaks
Review how long songs or albums charted
Identify an artist’s number-one and top-ten hits

Questions about Billboard

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this Billboard tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a Billboard account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from billboard.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 30, 2026.