# Billboard — Zapi reference

> Top music chart data.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/music/billboard
- Endpoint catalog: https://zpi.web.id/category/music
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Billboard

**Category:** music · **Slug:** `billboard`
**Detail page:** https://zpi.web.id/api/music/billboard

Top music chart data.

**Tags:** music, chart

### Chart

Get top music chart data.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/music:billboard/chart`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `chart` | enum(hot-100|billboard-200) | query | no | Chart slug. Default hot-100 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:billboard/chart?chart=hot-100" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:billboard/chart?chart=hot-100", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/music:billboard/chart?chart=hot-100",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "chart": "hot-100",
  "count": 100,
  "items": [
    {
      "rank": 1,
      "title": "Choosin' Texas",
      "artist": "Ella Langley"
    },
    {
      "rank": 2,
      "title": "Be Her",
      "artist": "Ella Langley"
    },
    {
      "rank": 3,
      "title": "Man I Need",
      "artist": "Olivia Dean"
    },
    {
      "rank": 4,
      "title": "I Just Might",
      "artist": "Bruno Mars"
    },
    {
      "rank": 5,
      "title": "So Easy (To Fall In Love)",
      "artist": "Olivia Dean"
    },
    {
      "rank": 6,
      "title": "Ordinary",
      "artist": "Alex Warren"
    },
    {
      "rank": 7,
      "title": "Drop Dead",
      "artist": "Olivia Rodrigo"
    },
    {
      "rank": 8,
      "title": "Risk It All",
      "artist": "Bruno Mars"
    },
    {
      "rank": 9,
      "title": "Folded",
      "artist": "Kehlani"
    },
    {
      "rank": 10,
      "title": "Dracula",
      "artist": "Tame Impala & JENNIE"
    },
    {
      "rank": 11,
      "title": "I Can't Love You Anymore",
      "artist": "Ella Langley & Morgan Wallen"
    },
    {
      "rank": 12,
      "title": "Stateside",
      "artist": "PinkPantheress With Zara Larsson"
    },
    {
      "rank": 13,
      "title": "Golden",
      "artist": "HUNTR/X: EJAE, Audrey Nuna & REI AMI"
    },
    {
      "rank": 14,
      "title": "The Fate Of Ophelia",
      "artist": "Taylor Swift"
    },
    {
      "rank": 15,
      "title": "Billie Jean",
      "artist": "Michael Jackson"
    },
    {
      "rank": 16,
      "title": "Daisies",
      "artist": "Justin Bieber"
    },
    {
      "rank": 17,
      "title": "Sleepless In A Hotel Room",
      "artist": "Luke Combs"
    },
    {
      "rank": 18,
      "title": "Opalite",
      "artist": "Taylor Swift"
    },
    {
      "rank": 19,
      "title": "Homewrecker",
      "artist": "sombr"
    },
    {
      "rank": 20,
      "title": "Boston",
      "artist": "Stella Lefty"
    },
    {
      "rank": 21,
      "title": "Human Nature",
      "artist": "Michael Jackson"
    },
    {
      "rank": 22,
      "title": "Be By You",
      "artist": "Luke Combs"
    },
    {
      "rank": 23,
      "title": "The Great Divide",
      "artist": "Noah Kahan"
    },
    {
      "rank": 24,
      "title": "Babydoll",
      "artist": "Dominic Fike"
    },
    {
      "rank": 25,
      "title": "Midnight Sun",
      "artist": "Zara Larsson"
    },
    {
      "rank": 26,
      "title": "Earrings",
      "artist": "Malcolm Todd"
    },
    {
      "rank": 27,
      "title": "Pop Dat Thang",
      "artist": "DaBaby"
    },
    {
      "rank": 28,
      "title": "The Fall",
      "artist": "Cody Johnson"
    },
    {
      "rank": 29,
      "title": "Beat It",
      "artist": "Michael Jackson"
    },
    {
      "rank": 30,
      "title": "Doors",
      "artist": "Noah Kahan"
    },
    {
      "rank": 31,
      "title": "Change My Mind",
      "artist": "Riley Green"
    },
    {
      "rank": 32,
      "title": "E85",
      "artist": "Don Toliver"
    },
    {
      "rank": 33,
      "title": "Loving Life Again",
      "artist": "Ella Langley"
    },
    {
      "rank": 34,
      "title": "Swim",
      "artist": "BTS"
    },
    {
      "rank": 35,
      "title": "Freakin' Out",
      "artist": "Dexter And The Moonrocks"
    },
    {
      "rank": 36,
      "title": "Don't Stop 'Til You Get Enough",
      "artist": "Michael Jackson"
    },
    {
      "rank": 37,
      "title": "American Girls",
      "artist": "Harry Styles"
    },
    {
      "rank": 38,
      "title": "Iloveitiloveitiloveit",
      "artist": "Bella Kay"
    },
    {
      "rank": 39,
      "title": "Brunette",
      "artist": "Tucker Wetmore"
    },
    {
      "rank": 40,
      "title": "Body",
      "artist": "Don Toliver"
    },
    {
      "rank": 41,
      "title": "Die On This Hill",
      "artist": "Sienna Spiro"
    },
    {
      "rank": 42,
      "title": "Lush Life",
      "artist": "Zara Larsson"
    },
    {
      "rank": 43,
      "title": "Fever Dream",
      "artist": "Alex Warren"
    },
    {
      "rank": 44,
      "title": "Dirty Diana",
      "artist": "Michael Jackson"
    },
    {
      "rank": 45,
      "title": "Dandelion",
      "artist": "Ella Langley"
    },
    {
      "rank": 46,
      "title": "Willing And Able",
      "artist": "Noah Kahan"
    },
    {
      "rank": 47,
      "title": "Rock With You",
      "artist": "Michael Jackson"
    },
    {
      "rank": 48,
      "title": "Let 'Em Know",
      "artist": "T.I."
    },
    {
      "rank": 49,
      "title": "End Of August",
      "artist": "Noah Kahan"
    },
    {
      "rank": 50,
      "title": "Elizabeth Taylor",
      "artist": "Taylor Swift"
    },
    {
      "rank": 51,
      "title": "Bottom Of Your Boots",
      "artist": "Ella Langley"
    },
    {
      "rank": 52,
      "title": "Don't We",
      "artist": "Morgan Wallen"
    },
    {
      "rank": 53,
      "title": "Porch Light",
      "artist": "Noah Kahan"
    },
    {
      "rank": 54,
      "title": "I Ain't Coming Back",
      "artist": "Morgan Wallen Featuring Post Malone"
    },
    {
      "rank": 55,
      "title": "Motion Party",
      "artist": "BossMan Dlow"
    },
    {
      "rank": 56,
      "title": "Orbiter",
      "artist": "Noah Kahan"
    },
    {
      "rank": 57,
      "title": "American Cars",
      "artist": "Noah Kahan"
    },
    {
      "rank": 58,
      "title": "Dashboard",
      "artist": "Noah Kahan"
    },
    {
      "rank": 59,
      "title": "White Keys",
      "artist": "Dominic Fike"
    },
    {
      "rank": 60,
      "title": "Cinderella",
      "artist": "Mac Miller Featuring Ty Dolla $ign"
    },
    {
      "rank": 61,
      "title": "Staying Still",
      "artist": "Noah Kahan"
    },
    {
      "rank": 62,
      "title": "Downfall",
      "artist": "Noah Kahan"
    },
    {
      "rank": 63,
      "title": "Obvious",
      "artist": "Chris Brown"
    },
    {
      "rank": 64,
      "title": "Raindance",
      "artist": "Dave & Tems"
    },
    {
      "rank": 65,
      "title": "Turn This Truck Around",
      "artist": "Jordan Davis"
    },
    {
      "rank": 66,
      "title": "Dry Spell",
      "artist": "Kacey Musgraves"
    },
    {
      "rank": 67,
      "title": "Haircut",
      "artist": "Noah Kahan"
    },
    {
      "rank": 68,
      "title": "McArthur",
      "artist": "HARDY , Eric Church , Morgan Wallen & Tim McGraw"
    },
    {
      "rank": 69,
      "title": "Beautiful Things",
      "artist": "Megan Moroney"
    },
    {
      "rank": 70,
      "title": "What You Need",
      "artist": "Tems"
    },
    {
      "rank": 71,
      "title": "Hate How You Look",
      "artist": "Josh Ross"
    },
    {
      "rank": 72,
      "title": "Don't Tell On Me",
      "artist": "Jason Aldean"
    },
    {
      "rank": 73,
      "title": "Self Aware",
      "artist": "Temper City"
    },
    {
      "rank": 74,
      "title": "What You Saying",
      "artist": "Lil Uzi Vert"
    },
    {
      "rank": 75,
      "title": "Deny Deny Deny",
      "artist": "Noah Kahan"
    },
    {
      "rank": 76,
      "title": "Pinky Up",
      "artist": "KATSEYE"
    },
    {
      "rank": 77,
      "title": "Rein Me In",
      "artist": "Sam Fender & Olivia Dean"
    },
    {
      "rank": 78,
      "title": "Rethink Some Things",
      "artist": "Luke Combs"
    },
    {
      "rank": 79,
      "title": "Dan",
      "artist": "Noah Kahan"
    },
    {
      "rank": 80,
      "title": "Fallin'",
      "artist": "Chris Brown Featuring Leon Thomas"
    },
    {
      "rank": 81,
      "title": "Paid Time Off",
      "artist": "Noah Kahan"
    },
    {
      "rank": 82,
      "title": "In My Room",
      "artist": "Julia Wolf"
    },
    {
      "rank": 83,
      "title": "Woman",
      "artist": "Kane Brown"
    },
    {
      "rank": 84,
      "title": "23",
      "artist": "Noah Kahan"
    },
    {
      "rank": 85,
      "title": "For The Moment",
      "artist": "Chris Brown"
    },
    {
      "rank": 86,
      "title": "Rock Music",
      "artist": "Charli xcx"
    },
    {
      "rank": 87,
      "title": "All Them Horses",
      "artist": "Noah Kahan"
    },
    {
      "rank": 88,
      "title": "Mr. Know It All",
      "artist": "Teddy Swims"
    },
    {
      "rank": 89,
      "title": "Damned If I Do",
      "artist": "Vincent Mason"
    },
    {
      "rank": 90,
      "title": "Noble",
      "artist": "F3miii"
    },
    {
      "rank": 91,
      "title": "Rocky Mountain Low",
      "artist": "Corey Kent & Koe Wetzel"
    },
    {
      "rank": 92,
      "title": "Honey Pack",
      "artist": "Chris Brown"
    },
    {
      "rank": 93,
      "title": "Sunburn",
      "artist": "Tucker Wetmore"
    },
    {
      "rank": 94,
      "title": "Father",
      "artist": "Ye & Travis Scott"
    },
    {
      "rank": 95,
      "title": "Ever Since U Left Me (I Went Deaf)",
      "artist": "French Montana & Max B"
    },
    {
      "rank": 96,
      "title": "Lighthouse",
      "artist": "Noah Kahan"
    },
    {
      "rank": 97,
      "title": "We Go Way Back",
      "artist": "Noah Kahan"
    },
    {
      "rank": 98,
      "title": "Runway",
      "artist": "Lady Gaga & Doechii"
    },
    {
      "rank": 99,
      "title": "Jane!",
      "artist": "The Long Faces"
    },
    {
      "rank": 100,
      "title": "Go Away",
      "artist": "Weezer Featuring Best Coast"
    }
  ]
}
```

---


_Generated: 2026-08-02T14:28:27.410Z_