# Billboard API: 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.

Unofficial. Not affiliated with or endorsed by Billboard.

- Page: https://fous.com/methods/billboard.com/get-artist-chart-history
- Method: `billboard.com/get_artist_chart_history`, version 1
- Website: billboard.com
- 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
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `chart` | string | no | `"billboard_200"` | Select the Billboard chart, for example hot_100. One of "hot_100", "billboard_200". Default "hot_100". |
| `artist` | string | yes | `"Adele"` | Artist name, for example Taylor Swift. |
| `max_results` | integer | no | `3` | Maximum titles returned, for example 100. Default 100. |

## Output

From a run on Oct 31, 2026. Its input:

```json
{
  "chart": "billboard_200",
  "artist": "Adele",
  "max_results": 3
}
```

Its output:

```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
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"billboard.com/get_artist_chart_history","input":{"chart":"billboard_200","artist":"Adele","max_results":3}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- How many Hot 100 entries does Drake have, and how many of them went to No. 1? List his songs with peak positions and weeks on chart.
- Pull up Fleetwood Mac's Billboard 200 album history — I want each album's debut date, peak position, and how long it stayed on the chart.
- Show me the 20 most recent songs Olivia Rodrigo has charted on the Billboard Hot 100, including where each one peaked.
- I'm writing a piece on Beyoncé's albums. Can you get her complete album chart run: total entries, No. 1 albums, top 10 albums, and weeks charted for each?
- Give me Bad Bunny's Billboard chart history for singles: number of top 10 hits plus every track's debut and peak date.

## Input schema

```json
{
  "type": "object",
  "required": [
    "artist"
  ],
  "properties": {
    "chart": {
      "enum": [
        "hot_100",
        "billboard_200"
      ],
      "type": "string",
      "default": "hot_100",
      "description": "Select the Billboard chart, for example hot_100."
    },
    "artist": {
      "type": "string",
      "minLength": 1,
      "description": "Artist name, for example Taylor Swift."
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum titles returned, for example 100."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "artist",
    "artist_link",
    "total_chart_entries",
    "number_one_hits",
    "top_10_hits",
    "entries"
  ],
  "properties": {
    "artist": {
      "type": "string"
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "peak_position",
          "peak_date",
          "debut_date",
          "weeks_on_chart",
          "page_link"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "page_link": {
            "type": "string"
          },
          "peak_date": {
            "type": "string"
          },
          "debut_date": {
            "type": "string"
          },
          "peak_position": {
            "type": "integer"
          },
          "weeks_on_chart": {
            "type": "integer"
          }
        }
      }
    },
    "artist_link": {
      "type": "string"
    },
    "top_10_hits": {
      "type": "integer"
    },
    "number_one_hits": {
      "type": "integer"
    },
    "total_chart_entries": {
      "type": "integer"
    }
  }
}
```

## See more

- [Billboard API: Get chart](https://fous.com/methods/billboard.com/get-chart.md): 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.
- [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
- [Deezer API: List top charts](https://fous.com/methods/deezer.com/list-top-charts.md): Lists current worldwide top tracks, albums or artists on Deezer in chart order, or tracks from Deezer's official Top <country> playlist.
- [Shazam API: List top charts](https://fous.com/methods/shazam.com/list-top-charts.md): Gets Shazam's current ranked top songs for the world, a country, or a city, optionally by genre. City charts have up to 50 songs; genres are available only in some places.
- [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles.
- [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
- [Apple API: List top App Store charts](https://fous.com/methods/apps.apple.com/list-top-charts.md): Lists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out.
- [Genius API: List an artist's songs](https://fous.com/methods/genius.com/list-artist-songs.md): Lists an artist's songs on Genius by popularity or newest release date, with featured artists, release dates, page views and song art. The artist can be given by name or by Genius artist link; dates or views may be unavailable.
- [All Billboard methods](https://fous.com/methods/billboard.com.md)