Genius
Search songs and fetch full lyrics from Genius. Returns clean text with section markers preserved.
2 endpoints8 calls
Search
Search the catalog by text query.
GET
/v1/music:genius/searchnot measured yet5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Search query (song/artist/album). Required. |
| perPage | number | query | Results per page (1-20). Default 10. |
Example response
{"project":"music:genius", "data": {"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" },"timestamp":"2026-05-27T13:27:15Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Lyrics
Fetch full song lyrics by URL or ID.
GET
/v1/music:genius/lyricsnot measured yet5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| url | string | query | Full song URL OR path (/The-weeknd-blinding-lights-lyrics). Provide this OR id. |
| id | number | query | Song ID from search results. Provide this OR url. |
Example response
{"project":"music:genius", "data": {"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" },"timestamp":"2026-05-27T13:27:15Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "music:genius", "search", { q: "blinding lights" });
Genius
Search songs and fetch full lyrics from Genius. Returns clean text with section markers preserved.
2 endpoints8 calls
Search the catalog by text query.
GET
/v1/…genius/searchnot measured yet5m cache
Try it
Parameters
q
string · query · required
Search query (song/artist/album).
perPage
number · query · optional
Results per page (1-20). Default 10.
Example response
{"project":"music:genius", "data": {"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" },"timestamp":"2026-05-27T13:27:15Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "music:genius", "search", { q: "blinding lights" });