Files
discogs-service/docs/data/documentation/discogsservice/client.json
T

1 line
109 KiB
JSON
Raw Normal View History

2026-03-24 01:54:43 +00:00
{"relationshipsSections":[{"title":"Conforms To","identifiers":["doc:\/\/DiscogsService\/documentation\/DiscogsService\/APIProtocol","doc:\/\/DiscogsService\/s8SendableP","doc:\/\/DiscogsService\/s16SendableMetatypeP"],"kind":"relationships","type":"conformsTo"}],"sections":[],"abstract":[{"text":"The Discogs API v2.0 is a RESTful interface to Discogs data. You can access JSON-formatted information about Database objects such as ","type":"text"},{"inlineContent":[{"text":"Artists","type":"text"}],"type":"emphasis"},{"text":", ","type":"text"},{"inlineContent":[{"text":"Releases","type":"text"}],"type":"emphasis"},{"text":", and ","type":"text"},{"inlineContent":[{"text":"Labels","type":"text"}],"type":"emphasis"},{"text":". Your application can also manage ","type":"text"},{"inlineContent":[{"type":"text","text":"User Collections"}],"type":"emphasis"},{"text":" and ","type":"text"},{"inlineContent":[{"text":"Wantlists","type":"text"}],"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":[{"kind":"keyword","text":"struct"},{"kind":"text","text":" "},{"kind":"identifier","text":"Client"}],"platforms":["macOS"]}]},{"content":[{"level":2,"anchor":"overview","text":"Overview","type":"heading"},{"inlineContent":[{"type":"text","text":"Some Discogs data is made available under the "},{"isActive":true,"identifier":"https:\/\/creativecommons.org\/public-domain\/cc0\/","type":"reference"},{"type":"text","text":" license, and some is restricted data, as defined in our "},{"isActive":true,"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use","type":"reference"},{"type":"text","text":"."}],"type":"paragraph"},{"inlineContent":[{"text":"Our monthly data dumps are available under the ","type":"text"},{"isActive":true,"overridingTitleInlineContent":[{"text":"CC0 No Rights Reserved","type":"text"}],"identifier":"https:\/\/creativecommons.org\/public-domain\/cc0\/","overridingTitle":"CC0 No Rights Reserved","type":"reference"},{"text":" license.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"type":"text","text":"If you utilize the Discogs API, you are subject to the "},{"type":"reference","overridingTitleInlineContent":[{"type":"text","text":"API Terms of Use"}],"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use","isActive":true,"overridingTitle":"API Terms of Use"},{"type":"text","text":". Please also ensure that any application you develop follows the Discogs "},{"type":"reference","overridingTitleInlineContent":[{"text":"Application Name and Description Policy","type":"text"}],"identifier":"https:\/\/support.discogs.com\/hc\/en-us\/articles\/360009334593-API-Terms-of-Use","isActive":true,"overridingTitle":"Application Name and Description Policy"}],"type":"paragraph"},{"level":1,"anchor":"Quickstart","text":"Quickstart","type":"heading"},{"inlineContent":[{"text":"If you just want to see some results right now, issue this ","type":"text"},{"inlineContent":[{"type":"text","text":"curl"}],"type":"emphasis"},{"text":" command:","type":"text"}],"type":"paragraph"},{"type":"codeListing","syntax":"bash","code":["curl https:\/\/api.discogs.com\/releases\/249504 --user-agent \"FooBarApp\/3.0\""]},{"level":1,"anchor":"General-information","text":"General information","type":"heading"},{"inlineContent":[{"inlineContent":[{"type":"text","text":"Your application must provide a User-Agent string that identifies itself"}],"type":"strong"},{"text":" - preferably something that follows ","type":"text"},{"identifier":"https:\/\/datatracker.ietf.org\/doc\/html\/rfc1945#section-3.7","type":"reference","isActive":true},{"text":". Some good examples include:","type":"text"}],"type":"paragraph"},{"type":"codeListing","syntax":null,"code":["AwesomeDiscogsBrowser\/0.1 +http:\/\/adb.example.com","LibraryMetadataEnhancer\/0.3 +http: