{"variants":[{"traits":[{"interfaceLanguage":"swift"}],"paths":["\/documentation\/discogsservice\/client"]}],"sections":[],"schemaVersion":{"patch":0,"minor":3,"major":0},"abstract":[{"type":"text","text":"The Discogs API v2.0 is a RESTful interface to Discogs data. You can access JSON-formatted information about Database objects such as "},{"inlineContent":[{"text":"Artists","type":"text"}],"type":"emphasis"},{"text":", ","type":"text"},{"inlineContent":[{"text":"Releases","type":"text"}],"type":"emphasis"},{"text":", and ","type":"text"},{"inlineContent":[{"type":"text","text":"Labels"}],"type":"emphasis"},{"text":". Your application can also manage ","type":"text"},{"inlineContent":[{"type":"text","text":"User Collections"}],"type":"emphasis"},{"text":" and ","type":"text"},{"inlineContent":[{"type":"text","text":"Wantlists"}],"type":"emphasis"},{"text":", create ","type":"text"},{"inlineContent":[{"text":"Marketplace","type":"text"}],"type":"emphasis"},{"text":" listings, and more.","type":"text"}],"kind":"symbol","primaryContentSections":[{"kind":"declarations","declarations":[{"languages":["swift"],"tokens":[{"text":"struct","kind":"keyword"},{"text":" ","kind":"text"},{"text":"Client","kind":"identifier"}],"platforms":["macOS"]}]},{"content":[{"level":2,"anchor":"overview","text":"Overview","type":"heading"},{"inlineContent":[{"type":"text","text":"Some Discogs data is made available under the "},{"type":"reference","isActive":true,"identifier":"https:\/\/creativecommons.org\/public-domain\/cc0\/"},{"type":"text","text":" license, and some is restricted data, as defined in our "},{"type":"reference","isActive":true,"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use"},{"type":"text","text":"."}],"type":"paragraph"},{"inlineContent":[{"type":"text","text":"Our monthly data dumps are available under the the "},{"overridingTitle":"CC0 No Rights Reserved","overridingTitleInlineContent":[{"type":"text","text":"CC0 No Rights Reserved"}],"type":"reference","isActive":true,"identifier":"https:\/\/creativecommons.org\/public-domain\/cc0\/"},{"type":"text","text":" license."}],"type":"paragraph"},{"inlineContent":[{"type":"text","text":"If you utilize the Discogs API, you are subject to the "},{"overridingTitle":"API Terms of Use","overridingTitleInlineContent":[{"type":"text","text":"API Terms of Use"}],"type":"reference","isActive":true,"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use"},{"type":"text","text":". Please also ensure that any application you develop follows the Discogs "},{"overridingTitle":"Application Name and Description Policy","overridingTitleInlineContent":[{"type":"text","text":"Application Name and Description Policy"}],"type":"reference","isActive":true,"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use"}],"type":"paragraph"},{"level":1,"anchor":"Quickstart","text":"Quickstart","type":"heading"},{"inlineContent":[{"type":"text","text":"If you just want to see some results right now, issue this "},{"type":"emphasis","inlineContent":[{"type":"text","text":"curl"}]},{"type":"text","text":" command:"}],"type":"paragraph"},{"code":["curl https:\/\/api.discogs.com\/releases\/249504 --user-agent \"FooBarApp\/3.0\""],"syntax":"bash","type":"codeListing"},{"level":1,"anchor":"General-information","text":"General information","type":"heading"},{"inlineContent":[{"type":"text","text":"General Information"}],"type":"paragraph"},{"inlineContent":[{"type":"strong","inlineContent":[{"type":"text","text":"Your application must provide a User-Agent string that identifies itself"}]},{"type":"text","text":" - preferably something that follows "},{"type":"reference","isActive":true,"identifier":"https:\/\/datatracker.ietf.org\/doc\/html\/rfc1945#section-3.7"},{"type":"text","text":". Some good examples include:"}],"type":"paragraph"},{"code":["AwesomeDiscogsBrowser\/0.1 +http:\/\/adb.example.com","LibraryMetadataEnhancer\/0.3 +http:\/\/example.com\/lime","MyDiscogsClient\/1.0+http:\/\
