# Genius Lyrics API > Real-time Genius music data as an API — songs, artists, albums and full song lyrics, returned as clean JSON. Search songs, or search across songs, artists and albums at once; fetch a song, artist or album by id; list an artist's songs ranked by popularity; and pull the full, cleaned lyrics of any song by id or by Genius URL. Live data with titles, primary and featured artists, page views, release dates, artwork, follower counts and social handles. The lyrics endpoint returns the complete song text with section markers ([Verse], [Chorus]) and the contributor header stripped. Ideal for music and lyrics apps, karaoke and sing-along tools, sentiment and language analysis, and metadata enrichment. 7 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/genius-api/..." ``` ## Pricing - **Free** (Free) — 1,200 calls/Mo, 3 req/s - **Starter** ($14/Mo) — 28,000 calls/Mo, 8 req/s - **Pro** ($47/Mo) — 160,000 calls/Mo, 20 req/s - **Mega** ($155/Mo) — 850,000 calls/Mo, 50 req/s ## Endpoints ### Search #### `GET /v1/search` — Search songs **Parameters:** - `query` (query, required, string) — Search query Example: `bohemian rhapsody` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/search?query=bohemian+rhapsody" ``` **Response:** ```json { "data": { "count": 10, "query": "bohemian rhapsody", "songs": [ { "id": 1063, "hot": false, "url": "https://genius.com/Queen-bohemian-rhapsody-lyrics", "path": "/Queen-bohemian-rhapsody-lyrics", "image": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.1000x1000x1.png", "title": "Bohemian Rhapsody", "pageviews": 11172589, "thumbnail": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.300x300x1.png", "full_title": "Bohemian Rhapsody by Queen", "release_date": "October 31, 1975", "primary_artist": { "id": 563, "url": "https://genius.com/artists/Queen", "name": "Queen", "image": "https://images.genius.com/3bc047e8b3c654ed28aedc69f93f8663.1000x1000x1.jpg", "verified": false }, "featured_artists": [] }, { "id": 2554116, "hot": false, "url": "https://genius.com/Panic-at-the-disco-bohemian-rhapsody-lyrics", "path": "/Panic-at-the-disco-bohemian-rhapsody-lyrics", "image": "https://images.genius.com/0a339ca9b0584bd2a8d2a8e60740ec56.1000x1000x1.jpg", "title": "Bohemian Rhapsody", "pagevi …(truncated, see openapi.json for full schema) ``` #### `GET /v1/search/multi` — Search songs, artists, albums **Parameters:** - `query` (query, required, string) — Search query Example: `queen` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/search/multi?query=queen" ``` **Response:** ```json { "data": { "query": "queen", "songs": [ { "id": 1063, "hot": false, "url": "https://genius.com/Queen-bohemian-rhapsody-lyrics", "path": "/Queen-bohemian-rhapsody-lyrics", "image": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.1000x1000x1.png", "title": "Bohemian Rhapsody", "pageviews": 11172050, "thumbnail": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.300x300x1.png", "full_title": "Bohemian Rhapsody by Queen", "release_date": "October 31, 1975", "primary_artist": { "id": 563, "url": "https://genius.com/artists/Queen", "name": "Queen", "image": "https://images.genius.com/3bc047e8b3c654ed28aedc69f93f8663.1000x1000x1.jpg", "verified": false }, "featured_artists": [] }, { "id": 299177, "hot": false, "url": "https://genius.com/Beyonce-drunk-in-love-lyrics", "path": "/Beyonce-drunk-in-love-lyrics", "image": "https://images.genius.com/822e0619fe28f3e35aba4eba567111e8.1000x1000x1.png", "title": "Drunk in Love", "pageviews": 8941306, "thumbnail": "https://images.genius.c …(truncated, see openapi.json for full schema) ``` ### Catalogue #### `GET /v1/album` — Album by id **Parameters:** - `id` (query, required, string) — Genius album id Example: `961787` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/album?id=961787" ``` **Response:** ```json { "data": { "album": { "id": 961787, "url": "https://genius.com/albums/Queen/Studio-collection", "name": "Studio Collection", "artist": { "id": 563, "url": "https://genius.com/artists/Queen", "name": "Queen", "image": "https://images.genius.com/3bc047e8b3c654ed28aedc69f93f8663.1000x1000x1.jpg", "verified": false }, "cover_art": "https://images.genius.com/225103ef88cca1bc85c804a1ded937a5.597x597x1.jpg", "full_title": "Studio Collection by Queen", "release_date": "September 25, 2015" } }, "meta": { "timestamp": "2026-06-07T16:48:28.859Z", "request_id": "1651da08-3206-4ce1-af64-f402e112cd88" }, "status": "ok", "message": "Album retrieved successfully", "success": true } ``` #### `GET /v1/artist` — Artist by id **Parameters:** - `id` (query, required, string) — Genius artist id Example: `563` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/artist?id=563" ``` **Response:** ```json { "data": { "artist": { "id": 563, "url": "https://genius.com/artists/Queen", "name": "Queen", "image": "https://images.genius.com/3bc047e8b3c654ed28aedc69f93f8663.1000x1000x1.jpg", "twitter": "QueenWillRock", "verified": false, "instagram": "officialqueenmusic", "description": "Formed in 1970, Queen was a British rock band whose classic line-up consisted of Freddie Mercury on lead vocals and piano, Brian May on lead guitar, Roger Taylor on drums, and John Deacon on bass. Although Mercury and May wrote the bulk of the band’s material, all four contributed to the songwriting, churning out huge hits. Initially a progressive rock band with strong metal influences, their sound evolved dramatically over time. The band went on to refine, if not define “stadium rock,” as they grew to become one of the most beloved rock bands of all time.\n\nTheir early progressive phase spawned epic tracks like “March of the Black Queen” and one international hit single: “Killer Queen”. But it was their 1975 track “Bohemian Rhapsody” which catapulted the group to super-stardom. The song reigned at #1 on the UK charts for nine weeks and has since been praised as one of the greatest songs of all time.\n\nMoving away from their album-orientated sound, the band only grew in popularity with such songs as “Somebody to Love”, “We Are the Champions”, “Don’t Stop Me Now” …(truncated, see openapi.json for full schema) ``` #### `GET /v1/artist/songs` — Artist songs **Parameters:** - `id` (query, required, string) — Genius artist id Example: `563` - `sort` (query, optional, string) — popularity or title Example: `popularity` - `limit` (query, optional, string) — Max songs (1–50) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/artist/songs?id=563&sort=popularity&limit=20" ``` **Response:** ```json { "data": { "count": 20, "songs": [ { "id": 1063, "hot": false, "url": "https://genius.com/Queen-bohemian-rhapsody-lyrics", "path": "/Queen-bohemian-rhapsody-lyrics", "image": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.1000x1000x1.png", "title": "Bohemian Rhapsody", "pageviews": 11172004, "thumbnail": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.300x300x1.png", "full_title": "Bohemian Rhapsody by Queen", "release_date": "October 31, 1975", "primary_artist": { "id": 563, "url": "https://genius.com/artists/Queen", "name": "Queen", "image": "https://images.genius.com/3bc047e8b3c654ed28aedc69f93f8663.1000x1000x1.jpg", "verified": false }, "featured_artists": [] }, { "id": 205311, "hot": false, "url": "https://genius.com/Queen-dont-stop-me-now-lyrics", "path": "/Queen-dont-stop-me-now-lyrics", "image": "https://images.genius.com/b711fe7bf0e4f43a9167dee9998071ea.1000x1000x1.png", "title": "Don’t Stop Me Now", "pageviews": 2509532, "thumbnail": "https://images.geniu …(truncated, see openapi.json for full schema) ``` #### `GET /v1/song` — Song by id **Parameters:** - `id` (query, required, string) — Genius song id Example: `1063` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/song?id=1063" ``` **Response:** ```json { "data": { "song": { "id": 1063, "hot": false, "url": "https://genius.com/Queen-bohemian-rhapsody-lyrics", "path": "/Queen-bohemian-rhapsody-lyrics", "image": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.1000x1000x1.png", "title": "Bohemian Rhapsody", "pageviews": 11171985, "thumbnail": "https://images.genius.com/718de9d1fbcaae9f3c9b1bf483bfa8f1.300x300x1.png", "full_title": "Bohemian Rhapsody by Queen", "release_date": "October 31, 1975", "primary_artist": { "id": 563, "url": "https://genius.com/artists/Queen", "name": "Queen", "image": "https://images.genius.com/3bc047e8b3c654ed28aedc69f93f8663.1000x1000x1.jpg", "verified": false }, "featured_artists": [] } }, "meta": { "timestamp": "2026-06-07T16:48:39.525Z", "request_id": "7ab28547-564c-4147-88d4-b9a24d56c14c" }, "status": "ok", "message": "Song retrieved successfully", "success": true } ``` ### Lyrics #### `GET /v1/lyrics` — Full song lyrics by id or url **Parameters:** - `id` (query, optional, string) — Genius song id Example: `1063` - `url` (query, optional, string) — Genius song url (alternative to id) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/lyrics?id=1063" ``` **Response:** ```json { "data": { "url": "https://genius.com/Queen-bohemian-rhapsody-lyrics", "title": "Bohemian Rhapsody", "artist": "Queen", "lyrics": "[Intro]\nIs this the real life? Is this just fantasy?\nCaught in a landslide, no escape from reality\nOpen your eyes, look up to the skies and see\nI'm just a poor boy, I need no sympathy (Ooh, poor boy)\nBecause I'm easy come, easy go, little high, little low\nAny way the wind blows (Ooh, the wind blows)\nDoesn't really matter to me, to me\n\n[Verse 1]\nMama, just killed a man\nPut a gun against his head, pulled my trigger, now he's dead\nMama, life had just begun\nBut now I've gone and thrown it all away\nMama, ooh, didn't mean to make you cry\nIf I'm not back again this time tomorrow\nCarry on, carry on as if nothing really matters\n\n[Verse 2]\nToo late, my time has come\nSends shivers down my spine, body's aching all the time\nGoodbye, everybody, I've got to go\nGotta leave you all behind and face the truth\nMama, ooh (Any way the wind blows)\nI don't wanna die (Ooh)\nI sometimes wish I'd never been born at all (Ooh, ooh, ooh, ooh, ooh)\n\n[Guitar Solo]\n\n[Verse 3]\nI see a little silhouetto of a man\nScaramouche, Scaramouche, will you do the Fandango?\nThunderbolt and lightning, very, very frightening me\n(Galileo) Galileo, (Galileo) Galileo, Galileo Figaro\nMagnifico (Oh-oh-oh-oh)\nBut I'm just a poor boy, nobody loves me\nHe's just a poor boy from a poor family\nSpare him his life from this monstrosity …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/genius-api/v1/meta" ``` **Response:** ```json { "data": { "service": "genius-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/song": "Song details by id.", "GET /v1/album": "Album details by id.", "GET /v1/artist": "Artist details by id.", "GET /v1/lyrics": "Full song lyrics by id or url.", "GET /v1/search": "Search songs.", "GET /v1/artist/songs": "An artist's songs.", "GET /v1/search/multi": "Search songs, artists and albums." }, "description": "Genius data: song, artist, album search and details, plus full song lyrics — real live data." }, "meta": { "timestamp": "2026-06-07T16:48:41.442Z", "request_id": "7a33c550-3f36-4856-aa6a-96d0b509a42a" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/genius-api OpenAPI spec: https://www.oanor.com/api/genius-api/openapi.json