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 run

Example results

Artist: Adele
Artist Link: billboard.com
Top 10 Hits: 4
Number One Hits: 3
Total Chart Entries: 6
Entries: Entries
Title Page Link Peak Date Debut Date Peak Position Weeks On Chart
30
billboard.com
2021-12-04
2021-12-04
1
69
25
billboard.com
2015-12-12
2015-12-12
1
223
iTunes Festival: London 2011 (EP)
billboard.com
2011-08-06
2011-07-30
50
2

Entries
Title	Page Link	Peak Date	Debut Date	Peak Position	Weeks On Chart
30	billboard.com	2021-12-04	2021-12-04	1	69
25	billboard.com	2015-12-12	2015-12-12	1	223
iTunes Festival: London 2011 (EP)	billboard.com	2011-08-06	2011-07-30	50	2

Example data · Run in Studio for fresh results.

About Billboard

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 by Fous from billboard.com and checked automatically; it last passed a check on Sep 30, 2026. Fous is not affiliated with Billboard.

Actions

Get artist chart history

1 credit per run

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 per run

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: Texas Hold 'Em
Artist`entries[].artist`	Text	Example: Taylor Swift
Status`entries[].status`	Text
Page URL`entries[].page_url`	Text	Example: https://www.billboard.com/charts/artist-100/2024-04-06/
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: 505
Chart Name`chart_name`	Text	Example: Billboard Artist 100
Chart Week Date`chart_week_date`	Date	Example: 2024-04-06

Example result

For Date: 2024-04-03, Chart: Artist 100, Max Results: 5

JSON

{
  "entries": [
    {
      "rank": 1,
      "title": null,
      "artist": "Taylor Swift",
      "status": null,
      "page_url": "https://www.billboard.com/charts/artist-100/2024-04-06/",
      "peak_position": 1,
      "last_week_rank": 1,
      "weeks_on_chart": 505
    },
    {
      "rank": 2,
      "title": null,
      "artist": "Future",
      "status": null,
      "page_url": "https://www.billboard.com/charts/artist-100/2024-04-06/",
      "peak_position": 1,
      "last_week_rank": 37,
      "weeks_on_chart": 332
    },
    {
      "rank": 3,
      "title": null,
      "artist": "Metro Boomin",
      "status": null,
      "page_url": "https://www.billboard.com/charts/artist-100/2024-04-06/",
      "peak_position": 3,
      "last_week_rank": 76,
      "weeks_on_chart": 87
    }
  ],
  "chart_name": "Billboard Artist 100",
  "chart_week_date": "2024-04-06"
}

For developers

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL

# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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

Is Fous affiliated with Billboard?

No. Fous is not affiliated with Billboard. This workflow reads the public billboard.com website and returns its data.

How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 30, 2026.