Billboard API

Any Billboard chart for any week, with ranks, peaks, weeks on chart and credits, as JSON.

The API.SH Billboard API returns Billboard charts as structured JSON. List the main weekly charts with their slugs, then pull any chart for any week since it began (the Hot 100 goes back to 1958). Each entry has rank, title, artist, last week's rank and change, peak position, weeks on chart, weeks at No. 1, new and re-entry flags, debut and peak dates, chart awards, songwriters, producers, label, RIAA certification and cover art.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Billboard chart

GET https://api.api.sh/billboard/v1/chart

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Billboard API

Chart history datasets

Pull the Hot 100 or Billboard 200 week by week with the date parameter to build a history of every song or album that charted.

/chart

Weekly chart tracking

Fetch this week's charts every week and alert on debuts, re-entries, new peaks and big movers using the change and award fields.

/chart /charts

Music industry and label research

Group chart entries by label, songwriter or producer to see who is behind the hits in a genre or period.

/chart

Playlist and app features

Turn any week's chart into a playlist, a 'number one on your birthday' feature or a music trivia game.

/chart

Chart catalog for your app

List the main charts with their names, kinds (songs, albums or artists) and slugs so users can pick which chart to follow.

/charts

Billboard data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Billboard API endpoints and prices

Every Billboard endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

Billboard chart /billboard/v1/chart	$1 · $2 PAYG 1 credit
Billboard charts list /billboard/v1/charts	$1 · $2 PAYG 1 credit

Call the Billboard API

Billboard chart: GET https://api.api.sh/billboard/v1/chart

curl "https://api.api.sh/billboard/v1/chart?name=hot-100" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/billboard/v1/chart",
    params={"name": "hot-100"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/billboard/v1/chart");
url.searchParams.set("name", "hot-100");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/billboard/v1/chart", "name", "hot-100")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Billboard" and "Billboard chart".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Billboard data

Public data only: no Billboard login, cookies or account needed
One key and one response shape for Billboard and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Billboard API

Billboard does not offer a public developer API for its charts; the chart data itself is compiled by Luminate, which licenses industry data commercially. Most "Billboard API" results are unofficial Python wrappers and RapidAPI listings that parse billboard.com. API.SH returns the public chart pages as JSON with one key and no setup.

Instead of maintaining a billboard.py script that breaks when the site changes, or picking between RapidAPI listings, API.SH gives you any chart and week through one key at a fixed price per call.

Billboard API questions

What Billboard data can I get?+

The list of main weekly charts with slugs and kind (/billboard/v1/charts) and any chart for any week (/billboard/v1/chart): rank, title, artist, last week, peak, weeks on chart, weeks at No. 1, debut and peak dates, awards, songwriters, producers, label, RIAA certification and images.

How much does the Billboard API cost?+

Every Billboard endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free Billboard API?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /billboard/v1/chart at 1 credit each.

Is there an official Billboard API?+

No public one. Billboard's chart data comes from Luminate, which sells data access to the industry. The free Billboard APIs you find are unofficial wrappers. API.SH is also unofficial, but it is maintained for you and returns the same JSON shape every time.

Do I need a Billboard account or login?+

No. API.SH reads public Billboard chart pages only. No endpoint uses a login, cookies or a subscription.

Can I get the Hot 100 for a past date?+

Yes. Call /billboard/v1/chart with name=hot-100 and a date such as 2024-01-06. Any week since the chart began works, and the same goes for the Billboard 200 and other chart slugs from billboard.com/charts.

Can I use it from Python or JavaScript?+

Yes. It is a plain HTTPS API that returns JSON, so any language works, and there are official API.SH SDKs for Python and JavaScript.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /billboard/v1/chart with name=hot-100 to get this week's Hot 100. Docs and request examples are at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.