Skip to content
GET /v1/charts

List known charts

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/billboard-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/billboard-api/v1/charts" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/billboard-api/v1/charts", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/billboard-api/v1/charts");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/billboard-api/v1/charts",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Any valid Billboard chart slug works via /v1/chart?chart=<slug>; this is a curated subset.",
        "count": 17,
        "charts": [
            {
                "slug": "hot-100",
                "title": "The Hot 100 — top songs across all genres"
            },
            {
                "slug": "billboard-200",
                "title": "The Billboard 200 — top albums"
            },
            {
                "slug": "artist-100",
                "title": "Artist 100 — most popular artists"
            },
            {
                "slug": "billboard-global-200",
                "title": "Billboard Global 200"
            },
            {
                "slug": "billboard-global-excl-us",
                "title": "Billboard Global Excl. U.S."
            },
            {
                "slug": "streaming-songs",
                "title": "Streaming Songs"
            },
            {
                "slug": "radio-songs",
                "title": "Radio Songs"
            },
            {
                "slug": "digital-song-sales",
                "title": "Digital Song Sales"
            },
            {
                "slug": "tiktok-billboard-top-50",
                "title": "TikTok Billboard Top 50"
            },
            {
                "slug": "country-songs",
                "title": "Hot Country Songs"
            },
            {
                "slug": "hot-rock-songs",
                "title": "Hot Rock & Alternative Songs"
            },
            {
                "slug": "hot-r-and-b-hip-hop-songs",
                "title": "Hot R&B/Hip-Hop Songs"
            },
            {
                "slug": "hot-rap-songs",
                "title": "Hot Rap Songs"
            },
            {
                "slug": "hot-dance-electronic-songs",
                "title": "Hot Dance/Electronic Songs"
            },
            {
                "slug": "hot-latin-songs",
                "title": "Hot Latin Songs"
            },
            {
                "slug": "hot-christian-songs",
                "title": "Hot Christian Songs"
            },
            {
                "slug": "pop-songs",
                "title": "Pop Airplay"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-02T16:53:13.715Z",
        "request_id": "33c504a5-57d5-4a93-9c06-854332b74288"
    },
    "status": "ok",
    "message": "List known charts",
    "success": true
}