{"primaryContentSections":[{"declarations":[{"tokens":[{"text":"struct","kind":"keyword"},{"text":" ","kind":"text"},{"text":"Client","kind":"identifier"}],"languages":["swift"],"platforms":["macOS"]}],"kind":"declarations"},{"content":[{"type":"heading","text":"Overview","level":2,"anchor":"overview"},{"type":"paragraph","inlineContent":[{"text":"Some Discogs data is made available under the ","type":"text"},{"type":"reference","identifier":"https:\/\/creativecommons.org\/public-domain\/cc0\/","isActive":true},{"text":" license, and some is restricted data, as defined in our ","type":"text"},{"type":"reference","identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use","isActive":true},{"text":".","type":"text"}]},{"type":"paragraph","inlineContent":[{"text":"Our monthly data dumps are available under the the ","type":"text"},{"type":"reference","overridingTitle":"CC0 No Rights Reserved","overridingTitleInlineContent":[{"type":"text","text":"CC0 No Rights Reserved"}],"identifier":"https:\/\/creativecommons.org\/public-domain\/cc0\/","isActive":true},{"text":" license.","type":"text"}]},{"type":"paragraph","inlineContent":[{"text":"If you utilize the Discogs API, you are subject to the ","type":"text"},{"type":"reference","overridingTitle":"API Terms of Use","overridingTitleInlineContent":[{"type":"text","text":"API Terms of Use"}],"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use","isActive":true},{"text":". Please also ensure that any application you develop follows the Discogs ","type":"text"},{"type":"reference","overridingTitle":"Application Name and Description Policy","overridingTitleInlineContent":[{"type":"text","text":"Application Name and Description Policy"}],"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use","isActive":true}]},{"type":"heading","text":"Quickstart","level":1,"anchor":"Quickstart"},{"type":"paragraph","inlineContent":[{"text":"If you just want to see some results right now, issue this ","type":"text"},{"type":"emphasis","inlineContent":[{"type":"text","text":"curl"}]},{"text":" command:","type":"text"}]},{"type":"codeListing","syntax":"bash","code":["curl https:\/\/api.discogs.com\/releases\/249504 --user-agent \"FooBarApp\/3.0\""]},{"type":"heading","text":"General information","level":1,"anchor":"General-information"},{"type":"paragraph","inlineContent":[{"text":"General Information","type":"text"}]},{"type":"paragraph","inlineContent":[{"type":"strong","inlineContent":[{"type":"text","text":"Your application must provide a User-Agent string that identifies itself"}]},{"text":" - preferably something that follows ","type":"text"},{"type":"reference","identifier":"https:\/\/datatracker.ietf.org\/doc\/html\/rfc1945#section-3.7","isActive":true},{"text":". Some good examples include:","type":"text"}]},{"type":"codeListing","syntax":null,"code":["AwesomeDiscogsBrowser\/0.1 +http:\/\/adb.example.com","LibraryMetadataEnhancer\/0.3 +http:\/\/example.com\/lime","MyDiscogsClient\/1.0 +http:\/\/mydiscogsclient.org"]},{"type":"paragraph","inlineContent":[{"text":"Please don’t just copy one of those! Make it unique so we can let you know if your application starts to misbehave - the alternative is that we just silently block it, which will confuse and infuriate your users.","type":"text"}]},{"type":"paragraph","inlineContent":[{"text":"Here are some bad examples that are unclear or obscure the nature of the application:","type":"text"}]},{"type":"codeListing","syntax":null,"code":["curl\/7.9.8 (i686-pc-linux-gnu) libcurl 7.9.8 (OpenSSL 0.9.6b)","Mozilla\/5.0 (X11; Linux i686; rv:6.0.2) Gecko\/20100101 Firefox\/6.0.2","my app"]},{"type":"heading","text":"Authentication","level":1,"anchor":"Authentication"},{"type":"paragraph","inlineContent":[{"text":"Most endpoints require authentication. The API supports multiple methods:","type":"text"}]},{"type":"orderedList","items":[{"content":[{"type":"paragraph","inlineContent":[{"inlineContent":[{"text":"DiscogsAuth(Key&Secret)
