{"openapi":"3.1.0","info":{"title":"Discogs API","version":"1.0.0","description":"Live data from Discogs, the largest community-built database and marketplace of music releases: search the whole database by text and type (release, artist, label, master), a release with its artists, year, genres, styles, labels and formats plus the collector-community signal (how many have it, want it, its average rating and copies for sale), an artist profile with aliases and members, the canonical master release grouping all editions, and a record label profile with parent and sublabels.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/discogs-api","description":"oanor gateway"}],"tags":[{"name":"Database"},{"name":"Search"},{"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/artist":{"get":{"operationId":"get_v1_artist","tags":["Database"],"summary":"An artist profile, aliases and members","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric Discogs artist id","schema":{"type":"string"},"example":"72872"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":72872,"uri":"https://www.discogs.com/artist/72872-Rick-Astley","name":"Rick Astley","urls":["http://www.rickastley.co.uk","http://www.facebook.com/RickAstley","http://www.instagram.com/officialrickastley","http://myspace.com/rickastley","http://twitter.com/rickastley","http://en.wikipedia.org/wiki/Rick_Astley","http://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw"],"groups":["Band Aid II","Ferry Aid","NHS Voices"],"source":"Discogs","aliases":["Dick Spatsley"],"members":[],"profile":"Rick Astley (b. February 6, 1966 in Newton-le-Willows, Lancashire, United Kingdom) was one of figures to rise up in the dance/pop-driven late '80s. He started as a studio-tea-boy in 1985 at the [l279756] and released his first own single in 1987, [i][m=96559][/i].\r\n\r\nIn 2007, Rick Astley became the subject of a viral internet meme in which millions of internet users were tricked into watching Rick Astley's video [i][url=https://youtu.be/dQw4w9WgXcQ]Never Gonna Give You Up[/url][/i] by posting it under the name of other popular video titles. The practice is now known as [url=https://knowyourmeme.com/memes/rickroll]rickrolling[/url].","real_name":"Richard Paul Astley"},"meta":{"timestamp":"2026-06-10T14:01:44.195Z","request_id":"747c005f-fbce-4dd0-9549-dd6a1a7158cf"},"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/label":{"get":{"operationId":"get_v1_label","tags":["Database"],"summary":"A record label profile, parent and sublabels","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric Discogs label id","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":1,"uri":"https://www.discogs.com/label/1-Planet-E","name":"Planet E","urls":["http://planet-e.net","http://planetecommunications.bandcamp.com","http://www.facebook.com/planetedetroit","http://www.flickr.com/photos/planetedetroit","http://www.instagram.com/carlcraignet","http://myspace.com/planetecom","http://myspace.com/planetedetroit","http://soundcloud.com/planetedetroit","http://twitter.com/planetedetroit","http://vimeo.com/user1265384","http://en.wikipedia.org/wiki/Planet_E_Communications","http://www.youtube.com/user/planetedetroit"],"source":"Discogs","profile":"[a=Carl Craig]'s classic techno label founded in 1991.\r\n\r\nOn at least 1 release, Planet E is listed as publisher.","sublabels":["Antidote (4)","Community Projects","Guilty Pleasures","I Ner Zon Sounds","Planet E Communications","Planet E Communications, Inc.","Planet E Productions","TWPENTY"],"contact_info":"Planet E Communications\r\nP.O. Box 27218\r\nDetroit, Michigan, MI 48227\r\nUSA\r\n\r\nPhone: +1 313 874 8729\r\nFax: +1 313 874 8732\r\nEmail: info@Planet-e.net"},"meta":{"timestamp":"2026-06-10T14:01:44.569Z","request_id":"fe46bfaf-e458-417f-b196-c94e4460283d"},"status":"ok","message":"Label 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/master":{"get":{"operationId":"get_v1_master","tags":["Database"],"summary":"A master release grouping all editions","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric Discogs master id","schema":{"type":"string"},"example":"8295"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":8295,"uri":"https://www.discogs.com/master/8295-Growing-Lateral","year":2008,"title":"Lateral","genres":["Electronic"],"source":"Discogs","styles":["Drone","Experimental","Ambient"],"artists":["Growing"],"track_count":4,"main_release":1244906},"meta":{"timestamp":"2026-06-10T14:01:44.984Z","request_id":"3c624414-4647-4511-8509-d4a14fedb55b"},"status":"ok","message":"Master 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/release":{"get":{"operationId":"get_v1_release","tags":["Database"],"summary":"A release with community have/want/rating","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric Discogs release id","schema":{"type":"string"},"example":"249504"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":249504,"uri":"https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up","year":1987,"title":"Never Gonna Give You Up","genres":["Electronic","Pop"],"labels":[{"name":"RCA","catno":"PB 41447"}],"source":"Discogs","styles":["Euro-Disco"],"artists":["Rick Astley"],"country":"UK","formats":[{"qty":1,"name":"Vinyl","descriptions":["7\"","45 RPM","Single","Stereo"]}],"released":"1987-07-00","community":{"have":4047,"want":580,"rating_count":231,"rating_average":3.84},"track_count":2,"lowest_price":0.89,"num_for_sale":115},"meta":{"timestamp":"2026-06-10T14:01:45.463Z","request_id":"809855f4-b2d5-45dd-8790-8265eea39700"},"status":"ok","message":"Release 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":["Search"],"summary":"Search the Discogs database","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"nirvana"},{"name":"type","in":"query","required":false,"description":"release, artist, label or master","schema":{"type":"string"},"example":"artist"},{"name":"per_page","in":"query","required":false,"description":"Results per page (max 50)","schema":{"type":"string"},"example":"20"},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"type":"artist","count":20,"query":"nirvana","source":"Discogs","results":[{"id":125246,"type":"artist","genre":[],"label":[],"title":"Nirvana","format":[]},{"id":307513,"type":"artist","genre":[],"label":[],"title":"Nirvana (2)","format":[]},{"id":2744248,"type":"artist","genre":[],"label":[],"title":"Nirvana (10)","format":[]},{"id":1087206,"type":"artist","genre":[],"label":[],"title":"Nirvana 2002","format":[]},{"id":1082359,"type":"artist","genre":[],"label":[],"title":"Nirvana (6)","format":[]},{"id":1176738,"type":"artist","genre":[],"label":[],"title":"Nirvana (7)","format":[]},{"id":816495,"type":"artist","genre":[],"label":[],"title":"Nirvana (5)","format":[]},{"id":457609,"type":"artist","genre":[],"label":[],"title":"Nirvana (4)","format":[]},{"id":1907189,"type":"artist","genre":[],"label":[],"title":"Paulette \"Nirvana\" Buckley","format":[]},{"id":2414323,"type":"artist","genre":[],"label":[],"title":"El Nirvana","format":[]},{"id":319676,"type":"artist","genre":[],"label":[],"title":"Nirvana (3)","format":[]},{"id":4634135,"type":"artist","genre":[],"label":[],"title":"Nirvana (13)","format":[]},{"id":965460,"type":"artist","genre":[],"label":[],"title":"The Nirvana Devils","format":[]},{"id":1389061,"type":"artist","genre":[],"label":[],"title":"Nirvana (8)","format":[]},{"id":5145389,"type":"artist","genre":[],"label":[],"title":"Nirvana (14)","format":[]},{"id":2103552,"type":"artist","genre":[],"label":[],"title":"Nirvana (9)","format":[]},{"id":5047262,"type":"artist","genre":[],"label":[],"title":"Nirvana Kelly","format":[]},{"id":3465490,"type":"artist","genre":[],"label":[],"title":"Approaching Nirvana","format":[]},{"id":934885,"type":"artist","genre":[],"label":[],"title":"Nirvana Bros.","format":[]},{"id":45870,"type":"artist","genre":[],"label":[],"title":"The Nirvana Sitar & String Group","format":[]}],"per_page":20,"total_items":439,"total_pages":22},"meta":{"timestamp":"2026-06-10T14:01:45.805Z","request_id":"c40c546c-f709-4719-b72c-884109702026"},"status":"ok","message":"Search completed 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":"Service metadata and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Discogs API (api.discogs.com, live)","service":"discogs-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/label":"A record label's profile, parent and sublabels (id=1).","GET /v1/artist":"An artist's profile, aliases and members (id=72872).","GET /v1/master":"A master release grouping all editions (id=8295).","GET /v1/search":"Search the Discogs database (q=nirvana, type=release|artist|label|master).","GET /v1/release":"A release with community have/want/rating (id=249504)."},"description":"Live data from Discogs, the largest community-built database and marketplace of music releases, via its public API. The search endpoint searches the whole database by text and type (release, artist, label, master); the release endpoint returns a release's artists, year, country, genres, styles, labels and formats plus the collector-community signal (how many have it, want it, its average rating and copies for sale); the artist endpoint returns an artist's profile, aliases, members and links; the master endpoint returns the canonical master release grouping all editions; the label endpoint returns a record label's profile, parent and sublabels. Live, no key, nothing stored. Distinct from the MusicBrainz, Spotify, Deezer, Genius and Last.fm-style music APIs — this is Discogs' own community-built release database with have/want and marketplace data.","upstream_status":"ok","sample_release_have":4047},"meta":{"timestamp":"2026-06-10T14:01:46.231Z","request_id":"ad9ad22b-e8eb-42b6-9327-0934d03b75bb"},"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":7000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":115000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1600,"monthly_call_quota":700000,"rps_limit":10,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4000,"monthly_call_quota":3800000,"rps_limit":20,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/discogs-api"}