# Genius — Zapi reference > Search songs and fetch full lyrics from Genius. Returns clean text with section markers preserved. **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/genius - 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 --- ## Genius **Category:** music · **Slug:** `genius` **Detail page:** https://zpi.web.id/api/music/genius Search songs and fetch full lyrics from Genius. Returns clean text with section markers preserved. **Tags:** music, lyrics, search ### Search Search the catalog by text query. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/music:genius/search` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `q` | string | query | yes | Search query (song/artist/album) | | `perPage` | number | query | no | Results per page (1-20). Default 10 | **cURL:** ```bash curl "https://api.zpi.web.id/v1/music:genius/search?q=blinding%20lights&perPage=1" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/music:genius/search?q=blinding%20lights&perPage=1", { 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:genius/search?q=blinding%20lights&perPage=1", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 10, "items": [ { "id": 817859, "url": "https://genius.com/albums/The-weeknd/Heartless-blinding-lights", "type": "album", "image": "https://images.genius.com/b0d113a7edc6cbed3a8bec9ef3140e4e.1000x1000x1.png", "title": "Heartless / Blinding Lights", "artist": "The Weeknd", "fullTitle": "Heartless / Blinding Lights by The Weeknd" }, { "id": 5049949, "url": "https://genius.com/The-weeknd-blinding-lights-lyrics", "path": "/The-weeknd-blinding-lights-lyrics", "type": "song", "image": "https://images.genius.com/34c1c35ca27a735e6e5f18611acb1c16.1000x1000x1.png", "title": "Blinding Lights", "artist": "The Weeknd", "fullTitle": "Blinding Lights by The Weeknd" }, { "id": 7809032, "url": "https://genius.com/Bladee-and-ecco2k-5-star-crest-4-vattenrum-lyrics", "path": "/Bladee-and-ecco2k-5-star-crest-4-vattenrum-lyrics", "type": "song", "image": "https://images.genius.com/256c3f06b722a602d21f7a2ea48bde67.1000x1000x1.png", "title": "5 Star Crest (4 Vattenrum)", "artist": "Bladee", "fullTitle": "5 Star Crest (4 Vattenrum) by Bladee & Ecco2k" }, { "id": 5049949, "url": "https://genius.com/The-weeknd-blinding-lights-lyrics", "path": "/The-weeknd-blinding-lights-lyrics", "type": "song", "image": "https://images.genius.com/34c1c35ca27a735e6e5f18611acb1c16.1000x1000x1.png", "title": "Blinding Lights", "artist": "The Weeknd", "fullTitle": "Blinding Lights by The Weeknd" }, { "id": 7809032, "url": "https://genius.com/Bladee-and-ecco2k-5-star-crest-4-vattenrum-lyrics", "path": "/Bladee-and-ecco2k-5-star-crest-4-vattenrum-lyrics", "type": "song", "image": "https://images.genius.com/256c3f06b722a602d21f7a2ea48bde67.1000x1000x1.png", "title": "5 Star Crest (4 Vattenrum)", "artist": "Bladee", "fullTitle": "5 Star Crest (4 Vattenrum) by Bladee & Ecco2k" }, { "id": 3043085, "url": "https://genius.com/artists/Blinding-lights", "type": "artist", "image": "https://assets.genius.com/images/default_banner.png?1779461979", "title": "Blinding Lights" }, { "id": 817859, "url": "https://genius.com/albums/The-weeknd/Heartless-blinding-lights", "type": "album", "image": "https://images.genius.com/b0d113a7edc6cbed3a8bec9ef3140e4e.1000x1000x1.png", "title": "Heartless / Blinding Lights", "artist": "The Weeknd", "fullTitle": "Heartless / Blinding Lights by The Weeknd" }, { "id": 18938, "url": "https://genius.com/videos/The-weeknds-heartless-explained", "type": "video", "title": "The Weeknd Goes On A Drug-Fueled Vegas Bender In His “Heartless” Video" }, { "id": 12581, "url": "https://genius.com/a/the-weeknd-s-blinding-lights-is-the-first-song-in-history-to-spend-a-full-year-in-the-top-10", "type": "article", "title": "The Weeknd’s “Blinding Lights” Is The First Song In History To Spend A Full Year In The Top 10" }, { "id": 19457664, "url": "https://genius.com/BlindingLights41524", "type": "user", "image": "https://assets.genius.com/images/default_banner.png?1779461979", "title": "BlindingLights41524" } ], "query": "blinding lights" } ``` --- ### Lyrics Fetch full song lyrics by URL or ID. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/music:genius/lyrics` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `url` | string | query | no | Full song URL OR path (/The-weeknd-blinding-lights-lyrics). Provide this OR id. | | `id` | number | query | no | Song ID from search results. Provide this OR url. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/music:genius/lyrics?url=https%3A%2F%2Fgenius.com%2FThe-weeknd-blinding-lights-lyrics&id=5193845" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/music:genius/lyrics?url=https%3A%2F%2Fgenius.com%2FThe-weeknd-blinding-lights-lyrics&id=5193845", { 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:genius/lyrics?url=https%3A%2F%2Fgenius.com%2FThe-weeknd-blinding-lights-lyrics&id=5193845", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "id": 5193845, "url": "https://genius.com/The-weeknd-blinding-lights-lyrics", "image": "https://images.genius.com/34c1c35ca27a735e6e5f18611acb1c16.1000x1000x1.png", "title": "Blinding Lights", "artist": "The Weeknd", "lyrics": "[Intro]\nYeah\n\n[Verse 1]\nI've been tryna call\nI've been on my own for long enough\nMaybe you can show me how to love, maybe\nI'm goin' through withdrawals\nYou don't even have to do too much\nYou can turn me on with just a touch, baby\n\n[Pre-Chorus]\nI look around and\nSin City's cold and empty (Oh)\nNo one's around to judge me (Oh)\nI can't see clearly when you're gone\n\n[Chorus]\nI said, ooh, I'm blinded by the lights\nNo, I can't sleep until I feel your touch (Touch)\nI said, ooh, I'm drowning in the night\nOh, when I'm like this, you're the one I trust\nHey, hey, hey\n\n[Verse 2]\nI'm running out of time\n'Cause I can see the sun light up the sky\nSo I hit the road in overdrive, baby, oh\n\n[Pre-Chorus]\nThe city's cold and empty (Oh)\nNo one's around to judge me (Oh)\nI can't see clearly when you're gone\n\n[Chorus]\nAnd I said, ooh, I'm blinded by the lights\nNo, I can't sleep until I feel your touch (Touch)\nI said, ooh, I'm drowning in the night\nOh, when I'm like this, you're the one I trust\n\n[Bridge]\nI'm just coming back to let you know (Back to let you know)\nI could never say it on the phone (Say it on the phone)\nWill never let you go this time (Ooh)\n\n[Chorus]\nI said, ooh, I'm blinded by the lights\nNo, I can't sleep until I feel your touch (Touch)\nHey, hey, hey\n\n[Post-Chorus]\nHey, hey, hey\n\n[Outro]\nI said, ooh, I'm blinded by the lights\nNo, I can't sleep until I feel your touch", "description": "“Blinding Lights” serves as the second single for The Weeknd’s fourth studio album, After Hours. It follows the record’s lead single, “Heartless,” which was released two days prior" } ``` --- _Generated: 2026-08-02T14:25:52.399Z_