Discogs

About Discogs

The Discogs API is a RESTful interface providing JSON-formatted access to Discogs' music database, covering objects such as artists, releases, labels, and masters. It supports search, pagination, and versioning through Accept headers, and offers three response formats: HTML, plaintext, and Discogs-flavored markup.

Beyond read access to database objects, the API allows applications to manage user identity and profiles, collections and wantlists, and user-submitted lists. It also supports Marketplace functionality, including creating and editing listings, managing orders and order messages, price suggestions, and inventory import/export.

Authentication is available via Discogs Auth or OAuth. Requests require a unique User-Agent string, and are rate-limited to 60 requests per minute for authenticated calls and 25 per minute for unauthenticated calls, tracked via response headers. Some data is available under a CC0 No Rights Reserved license, and use of the API is subject to Discogs' API Terms of Use and Application Name and Description Policy. Community-maintained client libraries exist for Node.js, PHP, Python, and Ruby.

Key features

• RESTful JSON access to Discogs database objects like Artists, Releases, and Labels
• Manage user Collections and Wantlists via API
• Create and manage Marketplace Listings, Orders, and Inventory
• OAuth and Discogs Auth flows for authenticated requests
• Pagination with configurable page size up to 100 items
• JSONP support via callback query parameter

Frequently asked questions