Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/chart

Any chart by slug

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/chart" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/billboard-api/v1/chart", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/billboard-api/v1/chart");
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/chart",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "chart": "hot-100",
        "count": 100,
        "title": "The Hot 100 — top songs across all genres",
        "entries": [
            {
                "rank": 1,
                "image": "https://charts-static.billboard.com/img/2009/04/drake-v3o-180x180.jpg",
                "title": "Janice STFU",
                "artist": "Drake",
                "last_week": 1,
                "peak_position": 1,
                "weeks_on_chart": 2
            },
            {
                "rank": 2,
                "image": "https://charts-static.billboard.com/img/2025/11/ellalangley-0yx-choosintexas-3s2-180x180.jpg",
                "title": "Choosin' Texas",
                "artist": "Ella Langley",
                "last_week": 5,
                "peak_position": 1,
                "weeks_on_chart": 32
            },
            {
                "rank": 3,
                "image": "https://charts-static.billboard.com/img/2023/06/ellalangley-yci-180x180.jpg",
                "title": "Be Her",
                "artist": "Ella Langley",
                "last_week": 14,
                "peak_position": 2,
                "weeks_on_chart": 15
            },
            {
                "rank": 4,
                "image": "https://charts-static.billboard.com/img/2009/04/drake-v3o-180x180.jpg",
                "title": "Shabang",
                "artist": "Drake",
                "last_week": 4,
                "peak_position": 4,
                "weeks_on_chart": 2
            },
            {
                "rank": 5,
                "image": "https://charts-static.billboard.com/img/2026/06/oliviarodrigo-3wl-thecure-gac-180x180.jpg",
                "title": "The Cure",
                "artist": "Olivia Rodrigo",
                "last_week": null,
                "peak_position": 5,
                "weeks_on_chart": 1
            },
            {
                "rank": 6,
                "image": "https://charts-static.billboard.com/img/2009/04/drake-v3o-180x180.jpg",
                "title": "Ran To Atlanta",
                "artist": "Drake Featuring Future & Molly Santana",
                "last_week": 2,
                "peak_position": 2,
                "weeks_on_chart": 2
            },
            {
                "rank": 7,
                "image": "https://charts-static.billboard.com/img/2022/01/oliviadean-8k4-180x180.jpg",
                "title": "So Easy (To Fall In Love)",
                "artist": "Olivia Dean",
                "last_week": 20,
                "peak_position": 5,
                "weeks_on_chart": 35
            },
            {
                "rank": 8,
                "image": "https://charts-static.billboard.com/img/2010/01/bruno-mars-8dl-180x180.jpg",
                "title": "I Just Might",
                "artist": "Bruno Mars",
                "last_week": 16,
                "peak_position": 1,
                "weeks_on_chart": 20
            },
            {
                "rank": 9,
 
…