{"openapi":"3.1.0","info":{"title":"Spotify API","version":"1.0.0","description":"Spotify music and podcast metadata as an API — no login, no OAuth. Resolve any Spotify track, album, artist or playlist by its id, spotify: URI or open.spotify.com URL and get clean JSON: names, the canonical Spotify ids and URIs, cover art, release dates, durations, explicit flags and 30-second audio previews. Albums come back with their full track list, artists with their top tracks, and playlists with their tracks and owner. A universal resolve endpoint auto-detects the entity type from any Spotify link, and an oEmbed endpoint returns the title, thumbnail and embeddable player HTML for any Spotify URL. Live data straight from Spotify's public embed. Ideal for enriching your catalogue with Spotify ids, building \"listen on Spotify\" links, previewing tracks, and matching music across services. 6 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/spotify-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"Resolve"},{"name":"Meta"}],"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/album":{"get":{"operationId":"get_v1_album","tags":["Lookup"],"summary":"Album with track list","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Spotify album id, URI or URL","schema":{"type":"string"},"example":"4aawyAB9vmqN3uQ7FjRGTy"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"album":{"id":"4aawyAB9vmqN3uQ7FjRGTy","uri":"spotify:album:4aawyAB9vmqN3uQ7FjRGTy","url":"https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy","name":"Global Warming","type":"album","tracks":[{"id":"6OmhkSOpvYBokMKQxpIGx2","title":"Global Warming (feat. Sensato)","artists":["Pitbull","Sensato"],"explicit":true,"playable":true,"subtitle":"Pitbull, Sensato","has_video":false,"duration_ms":85400,"audio_preview":"https://p.scdn.co/mp3-preview/81b57845f672fa5a0af749489e311ffb9fd552fe"},{"id":"2iblMMIgSznA464mNov7A8","title":"Don't Stop the Party (feat. TJR)","artists":["Pitbull","TJR"],"explicit":false,"playable":true,"subtitle":"Pitbull, TJR","has_video":false,"duration_ms":206120,"audio_preview":"https://p.scdn.co/mp3-preview/4791938e88ca063cb96a5fa8a7a2fad53d0c835e"},{"id":"4yOn1TEcfsKHUJCL2h1r8I","title":"Feel This Moment (feat. Christina Aguilera)","artists":["Pitbull","Christina Aguilera"],"explicit":false,"playable":true,"subtitle":"Pitbull, Christina Aguilera","has_video":false,"duration_ms":229506,"audio_preview":"https://p.scdn.co/mp3-preview/b962588e91271bb23b1ae0f7510824dc152a8466"},{"id":"7fmpKF0rLGPnP7kcQ5ZMm7","title":"Back in Time - featured in \"Men In Black 3\"","artists":["Pitbull"],"explicit":false,"playable":true,"subtitle":"Pitbull","has_video":false,"duration_ms":207440,"audio_preview":"https://p.scdn.co/mp3-preview/03b7d0b54b19ab95c621633f2761f8285d8f000b"},{"id":"3jStb2imKd6oUoBT1zq5lp","title":"Hope We Meet Again (feat. Chris Brown)","artists":["Pitbull","Chris Brown"],"explicit":false,"playable":true,"subtitle":"Pitbull, Chris Brown","has_video":false,"duration_ms":221133,"audio_preview":"https://p.scdn.co/mp3-preview/6afce83e02bcbfbc6277e9b310add6179ba5600a"},{"id":"6Q4PYJtrq8CBx7YCY5IyRN","title":"Party Ain't Over (feat. Usher & Afrojack)","artists":["Pitbull","USHER","AFROJACK"],"explicit":true,"playable":true,"subtitle":"Pitbull, USHER, AFROJACK","has_video":false,"duration_ms":243160,"audio_preview":"https://p.scdn.co/mp3-preview/c0eef14cc92ec73ae215e73c63474cb0d76ffa39"},{"id":"0QTVwqcOsYd73AOkYkk0Hg","title":"Drinks for You (Ladies Anthem) (feat. J. Lo)","artists":["Pitbull","Jennifer Lopez"],"explicit":false,"playable":true,"subtitle":"Pitbull, Jennifer Lopez","has_video":false,"duration_ms":196920,"audio_preview":"https://p.scdn.co/mp3-preview/c8dbfd9733901ad89a36bcba5427dd85f37feb40"},{"id":"10Sydb6AAFPdgCzCKOSZuI","title":"Have Some Fun (feat. The Wanted & Afrojack)","artists":["Pitbull","The Wanted","AFROJACK"],"explicit":true,"playable":true,"subtitle":"Pitbull, The Wanted, AFROJACK","has_video":false,"duration_ms":244920,"audio_preview":"https://p.scdn.co/mp3-preview/434334202a27a87178fdf76d38c9519bfb4c93fa"},{"id":"4k61iDqmtX9nI7RfLmp9aq","title":"Outta Nowhere (feat. Danny Mercer)","artists":["Pitbull","Danny Mercer"],"explicit":true,"playable":true,"subtitle":"Pitbull, Danny Mercer","has_video":false,"duration_ms":206800,"audio_preview":"https://p.scdn.co/mp3-preview/3e2bebcc61e6fd8d2c51f556a150374d77b4823d"},{"id":"7oGRkL31ElVMcevQDceT99","title":"Tchu Tchu Tcha (feat. Enrique Iglesias)","artists":["Pitbull","Enrique Iglesias"],"explicit":true,"playable":true,"subtitle":"Pitbull, Enrique Iglesias","has_video":false,"duration_ms":205800,"audio_preview":"https://p.scdn.co/mp3-preview/4fb82e67fa6458da3702bf6348890d0570a8376e"},{"id":"60xPqMqnHZl7Jfiu6E9q8X","title":"Last Night (feat. Afrojack & Havana Brown)","artists":["Pitbull","AFROJACK","Havana Brown"],"explicit":true,"playable":true,"subtitle":"Pitbull, AFROJACK, Havana Brown","has_video":false,"duration_ms":219600,"audio_preview":"https://p.scdn.co/mp3-preview/c7be10f151dcd40b37cb84c38461cccc84fddff3"},{"id":"1jAdXqOSICyXYLaW9ioSur","title":"I'm Off That","artists":["Pitbull"],"explicit":true,"playable":true,"subtitle":"Pitbull","has_video":false,"duration_ms":197520,"audio_preview":"https://p.scdn.co/mp3-preview/d9eacfc0cfe1d59403294286b68dba07e0e44639"},{"id":"0fjRYHFz9ealui1lfnN8it","title":"Echa Pa'lla (Manos Pa'rriba) (feat. Papayo)","artists":["Pitbull","Papayo"],"explicit":false,"playable":true,"subtitle":"Pitbull, Papayo","has_video":false,"duration_ms":196440,"audio_preview":"https://p.scdn.co/mp3-preview/8ae1ca3eae6289fc8f40035a8100dd34a351a872"},{"id":"7of35ktwTbL906Z1i3mT4K","title":"Everybody Fucks (feat. Akon & David Rush)","artists":["Pitbull","Akon","David Rush"],"explicit":true,"playable":true,"subtitle":"Pitbull, Akon, David Rush","has_video":false,"duration_ms":257613,"audio_preview":"https://p.scdn.co/mp3-preview/a2c2c6ad931dab7a51df3ba25c6f18ddd10170d1"},{"id":"2JA6A6Y5f4m7PawM58U2Op","title":"Get It Started (feat. Shakira)","artists":["Pitbull","Shakira"],"explicit":false,"playable":true,"subtitle":"Pitbull, Shakira","has_video":false,"duration_ms":245920,"audio_preview":"https://p.scdn.co/mp3-preview/d6f33dcb1f5d117ae266248996db879a5aba9fec"},{"id":"726qZxwhP0jVyIA0ujnnhb","title":"11:59 (feat. Vein)","artists":["Pitbull","Vein"],"explicit":true,"playable":true,"subtitle":"Pitbull, Vein","has_video":false,"duration_ms":217680,"audio_preview":"https://p.scdn.co/mp3-preview/2b3b9bf5c1c8b7192e4b535f7af11301d1f521af"},{"id":"6GPER1Sx8MrBiwWxdulg5Q","title":"Rain Over Me (feat. Marc Anthony) - Benny Benassi Remix","artists":["Pitbull","Marc Anthony","Alle","Benny Benassi"],"explicit":false,"playable":true,"subtitle":"Pitbull, Marc Anthony, Alle, Benny Benassi","has_video":false,"duration_ms":316480,"audio_preview":"https://p.scdn.co/mp3-preview/cad9ce18484c8a1ebf27f0e427e97959e586b8fa"},{"id":"4TWgcICXXfGty8MHGWJ4Ne","title":"International Love (feat. Chris Brown) - Jump Smokers Extended Mix","artists":["Pitbull","Chris Brown","Jump Smokers"],"explicit":false,"playable":true,"subtitle":"Pitbull, Chris Brown, Jump Smokers","has_video":false,"duration_ms":309626,"audio_preview":"https://p.scdn.co/mp3-preview/c48b3bb6e6497433f0187d201b7ae27cab0f1906"}],"artists":["Pitbull"],"explicit":false,"subtitle":"Pitbull","cover_art":"https://image-cdn-fa.spotifycdn.com/image/ab67616d00001e022c5b24ecfa39523a75c993c4","duration_ms":0,"track_count":18}},"meta":{"timestamp":"2026-06-07T16:47:09.004Z","request_id":"0cff0efc-af1d-46ff-92ef-adb128a11394"},"status":"ok","message":"Album 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/artist":{"get":{"operationId":"get_v1_artist","tags":["Lookup"],"summary":"Artist with top tracks","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Spotify artist id, URI or URL","schema":{"type":"string"},"example":"0OdUWJ0sBjDrqHygGUXeCF"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"artist":{"id":"0OdUWJ0sBjDrqHygGUXeCF","uri":"spotify:artist:0OdUWJ0sBjDrqHygGUXeCF","url":"https://open.spotify.com/artist/0OdUWJ0sBjDrqHygGUXeCF","name":"Band of Horses","type":"artist","explicit":false,"subtitle":"Top tracks","cover_art":"https://image-cdn-ak.spotifycdn.com/image/ab676161000051742cb57b092374b2f975ee9adc","top_tracks":[{"id":"5lRzWDEe7UuedU2QPsFg0K","title":"The Funeral","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":322173,"audio_preview":"https://p.scdn.co/mp3-preview/a3d4810ce9c8ea8771bf5d2de93cadc44ec1ee77"},{"id":"2IvNxLl01CTAfCOA103Tgx","title":"No One's Gonna Love You","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":217333,"audio_preview":"https://p.scdn.co/mp3-preview/69cbe47f7bc308d9a67cab573a56da229bee587c"},{"id":"7fgOmdonXZap1Kuz7hs3O1","title":"Is There A Ghost","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":179666,"audio_preview":"https://p.scdn.co/mp3-preview/07598faa7d1520f7d1647397fb70416422ec71a7"},{"id":"766EIreId79ZFBkiDO1Ial","title":"Our Swords","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":146306,"audio_preview":"https://p.scdn.co/mp3-preview/6efb15544057d40a89cf37e64a2e2f7c28db9237"},{"id":"6iYZuHW7IAUTvUpvRTVQZA","title":"The Great Salt Lake","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":285386,"audio_preview":"https://p.scdn.co/mp3-preview/3555806e3e4186a484c55c5335d2c8a6b94890fe"},{"id":"4DQ32rPL5URDxsm8RW1CfI","title":"Detlef Schrempf","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":268480,"audio_preview":"https://p.scdn.co/mp3-preview/f98220009da93ed031a065f16e7a450c67a5055b"},{"id":"2NFEpYfse5ycWOj80d37jP","title":"Warning Signs","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":260866,"audio_preview":"https://p.scdn.co/mp3-preview/ac9a7d5e1060ffe208eacd2a4479fc1e40daf31d"},{"id":"7kDhGzc1hgkQQyzpvBmKcX","title":"The General Specific","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":187053,"audio_preview":"https://p.scdn.co/mp3-preview/49cf3e997ec0408c96b93f67c885841afff6c910"},{"id":"74Ce6AExI71YEqAFz9UkMr","title":"I Go to the Barn Because I Like The","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":186653,"audio_preview":"https://p.scdn.co/mp3-preview/55dbca3315fd042e57ffa41ee841aa6c19827e49"},{"id":"6DVX4qug0tCQkdlcRT7nUf","title":"In A Drawer","artists":["Band of Horses"],"explicit":false,"playable":true,"subtitle":"Band of Horses","has_video":false,"duration_ms":238906,"audio_preview":"https://p.scdn.co/mp3-preview/74a26ceb51a97eaed0da0a28624bb2fb04cbec7d"}],"duration_ms":0,"top_track_count":10}},"meta":{"timestamp":"2026-06-07T16:47:09.362Z","request_id":"c417e408-110f-4383-a594-09b863fc9bfc"},"status":"ok","message":"Artist 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/playlist":{"get":{"operationId":"get_v1_playlist","tags":["Lookup"],"summary":"Playlist with tracks","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Spotify playlist id, URI or URL","schema":{"type":"string"},"example":"37i9dQZF1DXcBWIGoYBM5M"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"playlist":{"id":"37i9dQZF1DXcBWIGoYBM5M","uri":"spotify:playlist:37i9dQZF1DXcBWIGoYBM5M","url":"https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M","name":"Today’s Top Hits","type":"playlist","owners":["Spotify"],"tracks":[{"id":"20jbSiX29FDX4oQxBXyUEi","title":"hate that i made you love me","artists":["Ariana Grande"],"explicit":false,"playable":true,"subtitle":"Ariana Grande","has_video":false,"duration_ms":197949,"audio_preview":"https://p.scdn.co/mp3-preview/9fb8e09c9facc2d9443b6e57ae36d47bf83c01b8"},{"id":"5uPaqMMt59KGrdKIitDRqa","title":"I Knew It, I Knew You","artists":["Taylor Swift"],"explicit":false,"playable":true,"subtitle":"Taylor Swift","has_video":false,"duration_ms":178186,"audio_preview":"https://p.scdn.co/mp3-preview/d21ded2a54dde5461f908b1bf26f1b4bae5ac139"},{"id":"5yvVYFDUpbnjcnRBgjwTzM","title":"Dracula - JENNIE Remix","artists":["Tame Impala","JENNIE"],"explicit":true,"playable":true,"subtitle":"Tame Impala, JENNIE","has_video":false,"duration_ms":209720,"audio_preview":"https://p.scdn.co/mp3-preview/631b9cec18551169382ef4be4f01e40bc5523441"},{"id":"7yNf9YjeO5JXUE3JEBgnYc","title":"Babydoll","artists":["Dominic Fike"],"explicit":false,"playable":true,"subtitle":"Dominic Fike","has_video":false,"duration_ms":97960,"audio_preview":"https://p.scdn.co/mp3-preview/bf5ab98492256120bd9c48658e9c899c8692f77f"},{"id":"1qbmS6ep2hbBRaEZFpn7BX","title":"Man I Need","artists":["Olivia Dean"],"explicit":false,"playable":true,"subtitle":"Olivia Dean","has_video":false,"duration_ms":184000,"audio_preview":"https://p.scdn.co/mp3-preview/0a36635f94b4e44e6e4f5b7edb3f501d458812d9"},{"id":"6gkbtMtioHgtyGjrMel6ei","title":"drop dead","artists":["Olivia Rodrigo"],"explicit":false,"playable":true,"subtitle":"Olivia Rodrigo","has_video":false,"duration_ms":224998,"audio_preview":"https://p.scdn.co/mp3-preview/cef0e37851eb1113e1a366d95cb1e3d05a9505a3"},{"id":"65DbTqJKhbwqYbZ1Okr0rc","title":"Choosin' Texas","artists":["Ella Langley"],"explicit":false,"playable":true,"subtitle":"Ella Langley","has_video":false,"duration_ms":232226,"audio_preview":"https://p.scdn.co/mp3-preview/ad3f225321f11467402cc47e09f9ea1195f3de91"},{"id":"5y2ijHECwFYWqcAHKTZgzD","title":"Risk It All","artists":["Bruno Mars"],"explicit":false,"playable":true,"subtitle":"Bruno Mars","has_video":false,"duration_ms":204068,"audio_preview":"https://p.scdn.co/mp3-preview/2467ff71a7508c57a62112ee5beb996bd6b9e957"},{"id":"0eAuGrXyGFYwur9ARUe7LJ","title":"Earrings","artists":["Malcolm Todd"],"explicit":false,"playable":true,"subtitle":"Malcolm Todd","has_video":false,"duration_ms":151500,"audio_preview":"https://p.scdn.co/mp3-preview/20a1469df9f65a51878811bbe49979c418abc1b7"},{"id":"1DwscornXpj8fmOmYVlqZt","title":"Stateside + Zara Larsson","artists":["PinkPantheress","Zara Larsson"],"explicit":false,"playable":true,"subtitle":"PinkPantheress, Zara Larsson","has_video":false,"duration_ms":184761,"audio_preview":"https://p.scdn.co/mp3-preview/cc3201e7ed85d09f1683e591fd2eb964ea7247a6"},{"id":"514joG57v4yKTsfQmz7stz","title":"Janice STFU","artists":["Drake"],"explicit":true,"playable":true,"subtitle":"Drake","has_video":false,"duration_ms":237344,"audio_preview":"https://p.scdn.co/mp3-preview/1de9b315e1aa811aedaf905b1058b668b2d3146e"},{"id":"5BZsQlgw21vDOAjoqkNgKb","title":"DAISIES","artists":["Justin Bieber"],"explicit":false,"playable":true,"subtitle":"Justin Bieber","has_video":false,"duration_ms":176453,"audio_preview":"https://p.scdn.co/mp3-preview/d990a355be1d84adc0882bda733862fba7767e70"},{"id":"4EoJ151oQ5jY48z4RhSE96","title":"the cure","artists":["Olivia Rodrigo"],"explicit":true,"playable":true,"subtitle":"Olivia Rodrigo","has_video":false,"duration_ms":297090,"audio_preview":"https://p.scdn.co/mp3-preview/7559346825a2233855b5fc77e84a954606de3444"},{"id":"55lijDD6OAjLFFUHU9tcDm","title":"WHERE IS MY HUSBAND!","artists":["RAYE"],"explicit":false,"playable":true,"subtitle":"RAYE","has_video":false,"duration_ms":197142,"audio_preview":"https://p.scdn.co/mp3-preview/0194ff4186a1f53bff2cdf6d7660289ca8eb0e7e"},{"id":"3oTuTpF1F3A7rEC6RKsMRz","title":"Raindance (feat. Tems)","artists":["Dave","Tems"],"explicit":false,"playable":true,"subtitle":"Dave, Tems","has_video":false,"duration_ms":219743,"audio_preview":"https://p.scdn.co/mp3-preview/7d860804d259f81b4a7bc04900a5410d99995fd4"},{"id":"3qhlB30KknSejmIvZZLjOD","title":"End of Beginning","artists":["Djo"],"explicit":false,"playable":true,"subtitle":"Djo","has_video":false,"duration_ms":159245,"audio_preview":"https://p.scdn.co/mp3-preview/2f6f0965be46144eca9212258c7a2988376727a1"},{"id":"7MZHqgTVTnN6xZGYAcEEAf","title":"Rein Me In (with Olivia Dean)","artists":["Sam Fender","Olivia Dean"],"explicit":true,"playable":true,"subtitle":"Sam Fender, Olivia Dean","has_video":false,"duration_ms":339410,"audio_preview":"https://p.scdn.co/mp3-preview/6c85f9e4507e93478ee4adb7782f1a35a9d0e1ce"},{"id":"3sK8wGT43QFpWrvNQsrQya","title":"DtMF","artists":["Bad Bunny"],"explicit":true,"playable":true,"subtitle":"Bad Bunny","has_video":false,"duration_ms":237117,"audio_preview":"https://p.scdn.co/mp3-preview/e41ce6b82410d81c08baacca2a7169e5ace4287d"},{"id":"6sGIMrtIzQjdzNndVxe397","title":"So Easy (To Fall In Love)","artists":["Olivia Dean"],"explicit":false,"playable":true,"subtitle":"Olivia Dean","has_video":false,"duration_ms":169000,"audio_preview":"https://p.scdn.co/mp3-preview/e0ea7353932017364bdb12dc776e89b360abac42"},{"id":"7gtG45ieyQzKtNKobfLd49","title":"American Girls","artists":["Harry Styles"],"explicit":false,"playable":true,"subtitle":"Harry Styles","has_video":false,"duration_ms":213440,"audio_preview":"https://p.scdn.co/mp3-preview/b727b069e1fd5864ffa3c61edca662f87298231f"},{"id":"5IMpnpD0tQVcqWlVIgtAtV","title":"iloveitiloveitiloveit","artists":["Bella Kay"],"explicit":true,"playable":true,"subtitle":"Bella Kay","has_video":false,"duration_ms":183237,"audio_preview":"https://p.scdn.co/mp3-preview/bcb1c4999d947ff0541bc11b164d91069fad1669"},{"id":"1U90UBmMrQTx9GNweUA4LZ","title":"Hit the Wall","artists":["Gracie Abrams"],"explicit":false,"playable":true,"subtitle":"Gracie Abrams","has_video":false,"duration_ms":194376,"audio_preview":"https://p.scdn.co/mp3-preview/9d263de4e5913a2536f7e26c98684e68cc37466a"},{"id":"4qW3BbQAwZsrnu8a3ZRdyT","title":"Self Aware","artists":["Temper City"],"explicit":false,"playable":true,"subtitle":"Temper City","has_video":false,"duration_ms":180740,"audio_preview":"https://p.scdn.co/mp3-preview/98af5b6b77831ad55b6d1129148745705a311973"},{"id":"37UCSVSqiPGdR1DijOFyYY","title":"Midnight Sun","artists":["Zara Larsson"],"explicit":false,"playable":true,"subtitle":"Zara Larsson","has_video":false,"duration_ms":189898,"audio_preview":"https://p.scdn.co/mp3-preview/c5bbc379559c92c9d07e2cebf4a1e14029d01331"},{"id":"31TXxq8gfgYyrYClnYY48m","title":"The Fate of Ophelia","artists":["Taylor Swift"],"explicit":false,"playable":true,"subtitle":"Taylor Swift","has_video":false,"duration_ms":226073,"audio_preview":"https://p.scdn.co/mp3-preview/f2765af4fcb12d896343889d5faa8144f976f42b"},{"id":"5Zv2Icw3vKuzQXZRhgmXkH","title":"PASSENGER","artists":["Alex Warren"],"explicit":false,"playable":true,"subtitle":"Alex Warren","has_video":false,"duration_ms":159771,"audio_preview":"https://p.scdn.co/mp3-preview/9a4142583e0a270c1641478dd393ede352642c82"},{"id":"2gYTC8DsplN3RNdpdBcCOQ","title":"Die On This Hill","artists":["SIENNA SPIRO"],"explicit":false,"playable":true,"subtitle":"SIENNA SPIRO","has_video":false,"duration_ms":217008,"audio_preview":"https://p.scdn.co/mp3-preview/611d1aeb18e67857f012e3edfb8520c176db08d8"},{"id":"0kosUz0jePvjiz4ctmR6wL","title":"Dai Dai","artists":["Shakira","Burna Boy"],"explicit":false,"playable":true,"subtitle":"Shakira, Burna Boy","has_video":false,"duration_ms":223448,"audio_preview":"https://p.scdn.co/mp3-preview/a6955a6725dcf614e9915396987847ea0b509580"},{"id":"36idurZmYRjJ56KQ8JD9bN","title":"Boston","artists":["STELLA LEFTY"],"explicit":false,"playable":true,"subtitle":"STELLA LEFTY","has_video":false,"duration_ms":170859,"audio_preview":"https://p.scdn.co/mp3-preview/7ffa15bbf70382813f8661408e976cc41655b367"},{"id":"12bYYQaLqHliSXvRIYlq8G","title":"I Just Might","artists":["Bruno Mars"],"explicit":false,"playable":true,"subtitle":"Bruno Mars","has_video":false,"duration_ms":212973,"audio_preview":"https://p.scdn.co/mp3-preview/d3b9a6318dcc942387b69c677a80377044856d69"},{"id":"7tICCrK3CcyRFKza7yrR0z","title":"Homewrecker","artists":["sombr"],"explicit":false,"playable":true,"subtitle":"sombr","has_video":false,"duration_ms":209066,"audio_preview":"https://p.scdn.co/mp3-preview/d46acdc8f94c6fa471388c7a10c619bb08c88197"},{"id":"4WFgvKVfEhb3IUAFGrutTR","title":"Love Me Not","artists":["Ravyn Lenae"],"explicit":false,"playable":true,"subtitle":"Ravyn Lenae","has_video":false,"duration_ms":213466,"audio_preview":"https://p.scdn.co/mp3-preview/c660e524e84990f7687728af3ba09f9e071e585d"},{"id":"2LSmH4vxyRhkJ2pPqcmkXw","title":"NOBLE","artists":["F3miii"],"explicit":false,"playable":true,"subtitle":"F3miii","has_video":false,"duration_ms":185806,"audio_preview":"https://p.scdn.co/mp3-preview/5fada77b20c9b592ea707bf74334195c2b8a125f"},{"id":"68lbSrXDORS51pmyjZv712","title":"SWIM","artists":["BTS"],"explicit":false,"playable":true,"subtitle":"BTS","has_video":false,"duration_ms":159007,"audio_preview":"https://p.scdn.co/mp3-preview/acafb81cc609de53b9687a40f214f79d828b6947"},{"id":"0kl6Ozan3fuUdCl6TlB15v","title":"Talk To You (ft. 54 Ultra)","artists":["ANOTR","54 Ultra"],"explicit":false,"playable":true,"subtitle":"ANOTR, 54 Ultra","has_video":false,"duration_ms":191076,"audio_preview":"https://p.scdn.co/mp3-preview/b55c8fa4e31192a3e35ad53d3e889733f9cd9da1"},{"id":"1CPZ5BxNNd0n0nF4Orb9JS","title":"Golden","artists":["HUNTR/X","EJAE","AUDREY NUNA","REI AMI","KPop Demon Hunters Cast"],"explicit":false,"playable":true,"subtitle":"HUNTR/X, EJAE, AUDREY NUNA, REI AMI, KPop Demon Hunters Cast","has_video":false,"duration_ms":194607,"audio_preview":"https://p.scdn.co/mp3-preview/dd67a9a4df4f0dea7365b346ed45787b8da4b35a"},{"id":"42UBPzRMh5yyz0EDPr6fr1","title":"Manchild","artists":["Sabrina Carpenter"],"explicit":true,"playable":true,"subtitle":"Sabrina Carpenter","has_video":false,"duration_ms":213645,"audio_preview":"https://p.scdn.co/mp3-preview/37c21b6b0df9b7156527d0729a58b6db37c88a0a"},{"id":"2SaWT781xr3hHLdbVt5DB7","title":"Freakin’ Out","artists":["Dexter and The Moonrocks"],"explicit":false,"playable":true,"subtitle":"Dexter and The Moonrocks","has_video":false,"duration_ms":217897,"audio_preview":"https://p.scdn.co/mp3-preview/82a05331bdb809fb577faa0bac70e0c9489dccb9"},{"id":"05CjWFAcAlY6O9po6Qwakk","title":"Be Her","artists":["Ella Langley"],"explicit":false,"playable":true,"subtitle":"Ella Langley","has_video":false,"duration_ms":217240,"audio_preview":"https://p.scdn.co/mp3-preview/17eee24507cd710f88bb3ae4ea6c4157ed9b3489"},{"id":"3iU2qsthCTo5EeTE03l3Si","title":"Doors","artists":["Noah Kahan"],"explicit":true,"playable":true,"subtitle":"Noah Kahan","has_video":false,"duration_ms":231086,"audio_preview":"https://p.scdn.co/mp3-preview/0f730628dbcee974aefe883578d0aa74b06febf7"},{"id":"3d5NbAerF2MMHw9tdIxiFH","title":"SS26","artists":["Charli xcx"],"explicit":false,"playable":true,"subtitle":"Charli xcx","has_video":false,"duration_ms":167674,"audio_preview":"https://p.scdn.co/mp3-preview/fdfd89bf59bd84bf95e2eb12c5fed6f1e4cb2760"},{"id":"5rfOARz6QO73wPATyMtQQZ","title":"DANCE...","artists":["Slayyyter"],"explicit":true,"playable":true,"subtitle":"Slayyyter","has_video":false,"duration_ms":287055,"audio_preview":"https://p.scdn.co/mp3-preview/3288d161a278eb0dd831abe1b8668b4a84836be2"},{"id":"3cZajhyr8LmtPfHZ9296tj","title":"No Broke Boys","artists":["Disco Lines","Tinashe"],"explicit":true,"playable":true,"subtitle":"Disco Lines, Tinashe","has_video":false,"duration_ms":163994,"audio_preview":"https://p.scdn.co/mp3-preview/adb1ea6ef8ac4d8111d8222ed3355794689a8d76"},{"id":"5ViLKrbyL3HD6wsq3AB9eI","title":"White Keys","artists":["Dominic Fike"],"explicit":false,"playable":true,"subtitle":"Dominic Fike","has_video":false,"duration_ms":144101,"audio_preview":"https://p.scdn.co/mp3-preview/4c09f53084e36b6c85f8b2a44893c226a3194f42"},{"id":"3B4cjvGlPvyBLNG3AzEgkZ","title":"E85","artists":["Don Toliver"],"explicit":true,"playable":true,"subtitle":"Don Toliver","has_video":false,"duration_ms":153181,"audio_preview":"https://p.scdn.co/mp3-preview/6531864966b2fc846a74a9bc161d9bf4563ec2e9"},{"id":"1tz7RZirwiuaJw2p0jbdHb","title":"KOKO","artists":["Omar Courtz"],"explicit":true,"playable":true,"subtitle":"Omar Courtz","has_video":false,"duration_ms":195146,"audio_preview":"https://p.scdn.co/mp3-preview/bcbf3c78ed6508dcbe66148b4f1ff003ed8f4674"},{"id":"4KmkJjHTNlr1jFY56Lyz4E","title":"PINKY UP","artists":["KATSEYE"],"explicit":true,"playable":true,"subtitle":"KATSEYE","has_video":false,"duration_ms":131437,"audio_preview":"https://p.scdn.co/mp3-preview/363e18f745939a46e00a67355fbd7ee1364a2fd6"},{"id":"6DH13QYXK7lKkYHSU88N48","title":"Who Knows","artists":["Daniel Caesar"],"explicit":false,"playable":true,"subtitle":"Daniel Caesar","has_video":false,"duration_ms":226283,"audio_preview":"https://p.scdn.co/mp3-preview/695ea23e689a1816b09a8ac6f0874af0f5c38420"},{"id":"2fCwv2ppU5nTRTckomIGsd","title":"REDRED","artists":["CORTIS"],"explicit":false,"playable":true,"subtitle":"CORTIS","has_video":false,"duration_ms":163001,"audio_preview":"https://p.scdn.co/mp3-preview/06fb2bb357494081a5b8e753e9c56ccc83520f11"},{"id":"36OpC3NK7kQzcOo8qiCHaA","title":"The Visitor","artists":["SIENNA SPIRO"],"explicit":false,"playable":true,"subtitle":"SIENNA SPIRO","has_video":false,"duration_ms":228908,"audio_preview":"https://p.scdn.co/mp3-preview/14d34f50e60f8f42e4392530863ec73f1e425ed5"}],"explicit":false,"subtitle":"Spotify","cover_art":"https://i.scdn.co/image/ab67706f000000028c9dc68bd893f9232ac4ec29","duration_ms":0,"track_count":50}},"meta":{"timestamp":"2026-06-07T16:47:09.656Z","request_id":"ece6291c-e566-452a-a91e-d9cad0bcf9e0"},"status":"ok","message":"Playlist 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/track":{"get":{"operationId":"get_v1_track","tags":["Lookup"],"summary":"Track by id/uri/url","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Spotify track id, spotify: URI or open.spotify.com URL","schema":{"type":"string"},"example":"4uLU6hMCjMI75M1A2tKUQC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"track":{"id":"4uLU6hMCjMI75M1A2tKUQC","uri":"spotify:track:4uLU6hMCjMI75M1A2tKUQC","url":"https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC","name":"Never Gonna Give You Up","type":"track","artists":["Rick Astley"],"explicit":false,"cover_art":"https://image-cdn-fa.spotifycdn.com/image/ab67616d00001e0215ebbedaacef61af244262a8","duration_ms":213573,"release_date":"1987-11-12T00:00:00Z","audio_preview":"https://p.scdn.co/mp3-preview/b4c682084c3fd05538726d0a126b7e14b6e92c83","related_artist_uri":"spotify:artist:0gxyHStUsqpMadRV0Di1Qt"}},"meta":{"timestamp":"2026-06-07T16:47:10.353Z","request_id":"3e0ffe30-4fd2-4383-8d12-c7039014a226"},"status":"ok","message":"Track 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/oembed":{"get":{"operationId":"get_v1_oembed","tags":["Resolve"],"summary":"oEmbed for a Spotify URL","description":"","parameters":[{"name":"url","in":"query","required":true,"description":"Any Spotify URL","schema":{"type":"string"},"example":"https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"oembed":{"html":"<iframe style=\"border-radius: 12px\" width=\"100%\" height=\"352\" title=\"Spotify Embed: Global Warming\" frameborder=\"0\" allowfullscreen allow=\"autoplay; clipboard-write; encrypted-media; fullscreen; picture-in-picture\" loading=\"lazy\" src=\"https://open.spotify.com/embed/album/4aawyAB9vmqN3uQ7FjRGTy?utm_source=oembed\"></iframe>","type":"rich","title":"Global Warming","width":456,"height":352,"provider":"Spotify","thumbnail_url":"https://image-cdn-fa.spotifycdn.com/image/ab67616d00001e022c5b24ecfa39523a75c993c4"}},"meta":{"timestamp":"2026-06-07T16:47:10.706Z","request_id":"cfe8c797-a6e3-423a-9b33-ded6dd58b866"},"status":"ok","message":"oEmbed 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/resolve":{"get":{"operationId":"get_v1_resolve","tags":["Resolve"],"summary":"Resolve any Spotify link","description":"","parameters":[{"name":"url","in":"query","required":true,"description":"Any Spotify URL, URI or id (type auto-detected)","schema":{"type":"string"},"example":"https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC"},{"name":"type","in":"query","required":false,"description":"Type hint for a bare id (track, album, artist, playlist)","schema":{"type":"string"},"example":"track"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"entity":{"id":"4uLU6hMCjMI75M1A2tKUQC","uri":"spotify:track:4uLU6hMCjMI75M1A2tKUQC","url":"https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC","name":"Never Gonna Give You Up","type":"track","artists":["Rick Astley"],"explicit":false,"cover_art":"https://image-cdn-fa.spotifycdn.com/image/ab67616d00001e0215ebbedaacef61af244262a8","duration_ms":213573,"release_date":"1987-11-12T00:00:00Z","audio_preview":"https://p.scdn.co/mp3-preview/b4c682084c3fd05538726d0a126b7e14b6e92c83","related_artist_uri":"spotify:artist:0gxyHStUsqpMadRV0Di1Qt"}},"meta":{"timestamp":"2026-06-07T16:47:10.886Z","request_id":"df694b6e-bb81-489c-948c-00a9715b72cf"},"status":"ok","message":"Entity resolved 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"spotify-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/album":"Album with its track list.","GET /v1/track":"Track by id/uri/url.","GET /v1/artist":"Artist with top tracks.","GET /v1/oembed":"oEmbed (title, thumbnail, embed html) for any Spotify url.","GET /v1/resolve":"Any Spotify link → entity (auto-detect type).","GET /v1/playlist":"Playlist with its tracks."},"description":"Spotify metadata: track, album (with tracks), artist (with top tracks) and playlist (with tracks) lookups by Spotify id, uri or url, plus a universal resolver and oEmbed — real live data, no login."},"meta":{"timestamp":"2026-06-07T16:47:10.987Z","request_id":"39fa83d7-04ef-4412-90d7-111e89cbd21a"},"status":"ok","message":"Meta","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":1500,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1290,"monthly_call_quota":45000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4900,"monthly_call_quota":280000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":14900,"monthly_call_quota":1300000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/spotify-api"}