{"openapi":"3.1.0","info":{"title":"Lyrics API","version":"1.0.0","description":"Fetch full song lyrics by artist and title, and search across millions of songs to find the right track. Returns the lyrics as text and as an array of lines, ready to display or process.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/lyrics-api","description":"oanor gateway"}],"tags":[{"name":"Lyrics"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/lyrics":{"get":{"operationId":"get_v1_lyrics","tags":["Lyrics"],"summary":"Lyrics for an artist + title","description":"","parameters":[{"name":"artist","in":"query","required":true,"description":"Artist name","schema":{"type":"string"},"example":"Coldplay"},{"name":"title","in":"query","required":true,"description":"Song title","schema":{"type":"string"},"example":"Yellow"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"lines":["Look at the stars","look how they shine for you","and everything you do","yeah they were all yellow","I came along","I wrote a song for you","and all the things you do","and it was called yellow","So then I took my turn","oh what a thing to have done","and it was all yellow","","your skin","oh yeah your skin and bones","turn into something beautiful","and you know","you know I love you so","you know I love you so","","I swam across","I jumped across for you","oh what a thing to do","'cos you were all yellow","I drew a line","I drew a line for you","oh what a thing to do","and it was all yellow","","and your skin","oh yeah your skin and bones","turn into something beautiful","and you know","for you I bleed myself dry","for you I bleed myself dry","","it's true","look how they shine for you","look how they shine for you","look how they shine for","look how they shine for you","look how they shine for you","look how they shine","","look at the stars","look how they shine for you","and all the things that you do"],"title":"Yellow","artist":"Coldplay","lyrics":"Look at the stars\nlook how they shine for you\nand everything you do\nyeah they were all yellow\nI came along\nI wrote a song for you\nand all the things you do\nand it was called yellow\nSo then I took my turn\noh what a thing to have done\nand it was all yellow\n\nyour skin\noh yeah your skin and bones\nturn into something beautiful\nand you know\nyou know I love you so\nyou know I love you so\n\nI swam across\nI jumped across for you\noh what a thing to do\n'cos you were all yellow\nI drew a line\nI drew a line for you\noh what a thing to do\nand it was all yellow\n\nand your skin\noh yeah your skin and bones\nturn into something beautiful\nand you know\nfor you I bleed myself dry\nfor you I bleed myself dry\n\nit's true\nlook how they shine for you\nlook how they shine for you\nlook how they shine for\nlook how they shine for you\nlook how they shine for you\nlook how they shine\n\nlook at the stars\nlook how they shine for you\nand all the things that you do"},"meta":{"timestamp":"2026-05-30T00:13:47.788Z","request_id":"8c3b6f2d-259c-42ab-96a6-d442fa66f55e"},"status":"ok","message":"Lyrics retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Lyrics"],"summary":"Search songs (find artist + title)","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"bohemian rhapsody"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":15,"query":"bohemian rhapsody","results":[{"album":"A Night At The Opera (2011 Remaster)","cover":"http://cdn-images.dzcdn.net/images/cover/6706f1154083f461a348508c28030a30/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody (Remastered 2011)","artist":"Queen","preview":"http://cdnt-preview.dzcdn.net/api/1/1/e/3/9/0/e395ad329758f01e5787f03e5286636f.mp3?hdnea=exp=1780100928~acl=/api/1/1/e/3/9/0/e395ad329758f01e5787f03e5286636f.mp3*~data=user_id=0,application_id=42~hmac=6d7d35add3ef1fb8fb5acc9504e2df8524cd955a6f4917370f7e89b01e8ba74e"},{"album":"Bohemian Rhapsody (The Original Soundtrack)","cover":"http://cdn-images.dzcdn.net/images/cover/8b8fc5d117f9357b79f0a0a410a170e8/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody (Live Aid)","artist":"Queen","preview":"http://cdnt-preview.dzcdn.net/api/1/1/c/9/3/0/c93393b8a00a8489617f00819b2a81da.mp3?hdnea=exp=1780100928~acl=/api/1/1/c/9/3/0/c93393b8a00a8489617f00819b2a81da.mp3*~data=user_id=0,application_id=42~hmac=973cd84dc5189a34a5a4a4934307df9af79a4d47bb8299ab64a10609c8c166b9"},{"album":"Live At Wembley Stadium","cover":"http://cdn-images.dzcdn.net/images/cover/90192223423fbfa45bbf4ef9f68cf9f7/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody (Live At Wembley Stadium / July 1986)","artist":"Queen","preview":"http://cdnt-preview.dzcdn.net/api/1/1/6/2/d/0/62dbc60a45f6d0784cd5ced0f46bf29d.mp3?hdnea=exp=1780100928~acl=/api/1/1/6/2/d/0/62dbc60a45f6d0784cd5ced0f46bf29d.mp3*~data=user_id=0,application_id=42~hmac=613a62f8fa11d735350975792995bd7e58f009d2c4707e6965a03fa9d0adc322"},{"album":"Ivory","cover":"http://cdn-images.dzcdn.net/images/cover/48b151ba06ef7b94fadc73db908532cd/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody","artist":"Junity","preview":"http://cdnt-preview.dzcdn.net/api/1/1/7/d/b/0/7db4c15ff7c4502451cf5b5c19799511.mp3?hdnea=exp=1780100928~acl=/api/1/1/7/d/b/0/7db4c15ff7c4502451cf5b5c19799511.mp3*~data=user_id=0,application_id=42~hmac=f3d9065af84b2d9c94c033a703c07545e1058319212a99a5ce55062aa736d00c"},{"album":"Here We Come","cover":"http://cdn-images.dzcdn.net/images/cover/a66f686d24596a770a5307166846f407/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody","artist":"The Braids","preview":"http://cdnt-preview.dzcdn.net/api/1/1/3/3/0/0/3308d153a75f625111da7e0b4b09bbc1.mp3?hdnea=exp=1780100928~acl=/api/1/1/3/3/0/0/3308d153a75f625111da7e0b4b09bbc1.mp3*~data=user_id=0,application_id=42~hmac=05cae9009016c94e01d2f6cc432d64f335ada695fcbabf635737e33698d1e3e3"},{"album":"Bohemian Rhapsody","cover":"http://cdn-images.dzcdn.net/images/cover/8d4520a90e1f688ccb99037d5a8492ff/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody","artist":"Angelina Jordan","preview":"http://cdnt-preview.dzcdn.net/api/1/1/7/c/1/0/7c15259b85adeb212e583bf62b7144f8.mp3?hdnea=exp=1780100928~acl=/api/1/1/7/c/1/0/7c15259b85adeb212e583bf62b7144f8.mp3*~data=user_id=0,application_id=42~hmac=653e9924259cbe1f6e492ee09dcf0e96ecb961239c1875e43d336810049f3413"},{"album":"On Fire: Live At The Bowl","cover":"http://cdn-images.dzcdn.net/images/cover/058be6c8367fa3efa3d290d9231a370e/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody (Live At Milton Keynes Bowl / June 1982)","artist":"Queen","preview":"http://cdnt-preview.dzcdn.net/api/1/1/f/9/0/0/f90843087e8ec037d22f06f02b036542.mp3?hdnea=exp=1780100928~acl=/api/1/1/f/9/0/0/f90843087e8ec037d22f06f02b036542.mp3*~data=user_id=0,application_id=42~hmac=10036795892c9919fe2817e0421ac2f29740f8d8ffa180751654b2fbf920201b"},{"album":"Babies Love Queen","cover":"http://cdn-images.dzcdn.net/images/cover/548c11cfea542867dfa185e609c3771f/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody","artist":"Judson Mancebo","preview":"http://cdnt-preview.dzcdn.net/api/1/1/8/3/c/0/83c3b39a8e5cb17d8c0d25e4c0453381.mp3?hdnea=exp=1780100928~acl=/api/1/1/8/3/c/0/83c3b39a8e5cb17d8c0d25e4c0453381.mp3*~data=user_id=0,application_id=42~hmac=b811a011148a4c367ac65a4ecd56aa078d9fc9228988aa72b1a29bd87e56deb8"},{"album":"PTX Vol. IV - Classics","cover":"http://cdn-images.dzcdn.net/images/cover/b7df9f9e85e93f6d1262fb4764c25cec/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody","artist":"Pentatonix","preview":"http://cdnt-preview.dzcdn.net/api/1/1/2/e/5/0/2e5f3f67a6b3fe2a77ff75461f7a2892.mp3?hdnea=exp=1780100928~acl=/api/1/1/2/e/5/0/2e5f3f67a6b3fe2a77ff75461f7a2892.mp3*~data=user_id=0,application_id=42~hmac=581b42296452e67cbd1386cf4f0fe4f73691f879fc04bd18aeba2a55d3080526"},{"album":"Songs of Anarchy, Vol. 4 (Music from Sons of Anarchy)","cover":"http://cdn-images.dzcdn.net/images/cover/7b7e6baf676627807753dd1f7c984f29/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody (feat. The White Buffalo, Billy Valentine & Franky Perez) (From Sons of Anarchy)","artist":"The Forest Rangers","preview":"http://cdnt-preview.dzcdn.net/api/1/1/7/a/3/0/7a3a3867dfd5e4ceaf3402fde1772c6c.mp3?hdnea=exp=1780100928~acl=/api/1/1/7/a/3/0/7a3a3867dfd5e4ceaf3402fde1772c6c.mp3*~data=user_id=0,application_id=42~hmac=0331ff462337ac075851b022ff5cfcd60c515ab34dc69c2947d3dd0ddca6d96b"},{"album":"Bohemian Rhapsody","cover":"http://cdn-images.dzcdn.net/images/cover/55fbb4d4fcc1e6e6fae8695913a64bad/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody","artist":"Randy Coleman","preview":"http://cdnt-preview.dzcdn.net/api/1/1/a/6/3/0/a630b0d3ff535308e99813f6321f5e16.mp3?hdnea=exp=1780100928~acl=/api/1/1/a/6/3/0/a630b0d3ff535308e99813f6321f5e16.mp3*~data=user_id=0,application_id=42~hmac=1c51ca676eed044f972716fa0f458a0f8b8d21d27f4a2980cf8dea048613dcb2"},{"album":"Suicide Squad: The Album","cover":"http://cdn-images.dzcdn.net/images/cover/552f4b953a02ecb92268b1c7a80d9b2d/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody","artist":"Panic! At the Disco","preview":"http://cdnt-preview.dzcdn.net/api/1/1/f/4/f/0/f4f66dcebe747c090c571d041cbc73ed.mp3?hdnea=exp=1780100928~acl=/api/1/1/f/4/f/0/f4f66dcebe747c090c571d041cbc73ed.mp3*~data=user_id=0,application_id=42~hmac=fe5aae9febc3f4905168c0a6971f2729bcd85a13daf2860d62b9678ac4c5e684"},{"album":"Bohemian Rhapsody (Acoustic)","cover":"http://cdn-images.dzcdn.net/images/cover/14e87759889584a3395a7269a25e45f8/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody (Acoustic)","artist":"John Adams","preview":"http://cdnt-preview.dzcdn.net/api/1/1/f/4/7/0/f47837767513e481d59d67036aad96df.mp3?hdnea=exp=1780100928~acl=/api/1/1/f/4/7/0/f47837767513e481d59d67036aad96df.mp3*~data=user_id=0,application_id=42~hmac=694fc4cf78e0e37bdad83279be095bc2260245d8e2d4baaab918db5c40e2aadd"},{"album":"Queen Rock Montreal","cover":"http://cdn-images.dzcdn.net/images/cover/6c10466c0d64d2cda8ae3462c14ffec5/250x250-000000-80-0-0.jpg","title":"Bohemian Rhapsody (Live)","artist":"Queen","preview":"http://cdnt-preview.dzcdn.net/api/1/1/c/e/f/0/cefd6bd9251e9559f32682518ed16c7d.mp3?hdnea=exp=1780100928~acl=/api/1/1/c/e/f/0/cefd6bd9251e9559f32682518ed16c7d.mp3*~data=user_id=0,application_id=42~hmac=241f77d3f338d7dc5a3de6e8494d9558aebcb89e8de5f782394c9a8a404778cb"},{"album":"Don't Stop Me Now","cover":"http://cdn-images.dzcdn.net/images/cover/87e4c0897cf676a571a5f0109b4814c7/250x250-000000-80-0-0.jpg","title":"Don't Stop Me Now","artist":"Bohemian Rhapsody","preview":"http://cdnt-preview.dzcdn.net/api/1/1/0/5/4/0/054fc1af896806b94f7883707e33edea.mp3?hdnea=exp=1780100928~acl=/api/1/1/0/5/4/0/054fc1af896806b94f7883707e33edea.mp3*~data=user_id=0,application_id=42~hmac=357f9b6d46196d5b4483f3ebca9fa28743b8b8d869b326d0050878af73f82e45"}]},"meta":{"timestamp":"2026-05-30T00:13:48.337Z","request_id":"30313685-d188-431d-9cdb-a9af5c919420"},"status":"ok","message":"Songs retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":750,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":700,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":200000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":1200000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/lyrics-api"}