Discogs is a community-built music database and marketplace for physical music releases (vinyl, CD, cassette, and more). The Discogs API gives developers programmatic read/write access to artists, releases, masters, labels, search, user collections and wantlists, marketplace listings, orders, and inventory management — using Discogs Auth tokens, key+secret credentials, or full OAuth 1.0a on behalf of other users.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Music
- Marketplace
- Catalog
- Community
- Vinyl
- Public APIs
- Created: 2026-05-28
- Modified: 2026-05-29
RESTful API to the Discogs music catalog and marketplace. Covers the Database (artist, release, master, label, search), authenticated User surfaces (identity, profile, collection, wantlist, lists, contributions, submissions, ratings), Marketplace (inventory, orders, listings, fees, price suggestions, release stats), bulk Inventory Management (CSV export/upload), and OAuth-signed Image retrieval.
Human URL: https://www.discogs.com/developers
Base URL: https://api.discogs.com
- Database
- Marketplace
- User Identity
- User Collection
- User Wantlist
- User Lists
- Inventory Management
- Image
- Documentation
- APIReference
- Authentication
- TermsOfService
- OpenAPI
- Python SDK (Joalla Community Continuation)
- Python SDK (Modern Reimplementation)
- Java SDK (Community)
- Swift Service (Community)
- PHP SDK (Discogs Client - Deprecated Official)
- Monthly XML Data Dumps
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- Website
- Documentation
- APIReference
- TermsOfService
- Authentication
- Support
- Forum
- Status
- Blog
- Plans
- RateLimits
- GitHubOrganization
- PublicAPIsListing
- Monthly XML Data Dumps
- MCP Server (cswkim)
- MCP Server (rianvdm OAuth)
- MCP Server (pipeworx-io)
- MCP Server (andylobban Self-hostable)
- MCP Server (leosakharoff)
- Vocabulary
- SpectralRuleset
- JSONLDContext
| Name | Description |
|---|---|
| Database Search | Free-text search across releases, masters, artists, and labels with rich filters (year, country, format, label, genre, style, barcode, catno). |
| Release Catalog | Detailed release records including tracks, formats, labels, artists, videos, identifiers, community stats, and marketplace stats. |
| User Collection Management | Read and modify user record collections, organized into custom folders with notes and rating per copy. |
| User Wantlist | Track wanted releases, with notes and ratings; add and remove releases programmatically. |
| Marketplace Listings | List, update, and delete records for sale; query inventory by username; integrate with checkout flows via the Listing endpoints. |
| Marketplace Orders | Inspect, update, and message on orders the authenticated seller has received. |
| Price Suggestions | Get Discogs-calculated suggested marketplace prices by release and media condition. |
| Bulk Inventory Management | CSV-driven bulk add, change, and delete of inventory listings via asynchronous upload jobs; full inventory export to CSV. |
| OAuth 1.0a | Three-legged OAuth 1.0a flow for building third-party apps that act on behalf of other Discogs users. |
| Monthly XML Data Dumps | Discogs publishes a monthly snapshot of the full database (artists, labels, masters, releases) as XML on S3 for bulk analysis. |
| Name | Description |
|---|---|
| Music Discovery Apps | Build apps that surface release metadata, cover art, video links, community ratings, and label discographies. |
| Vinyl Reseller Tools | Power inventory management, pricing, and order workflows for vinyl resellers selling on the Discogs Marketplace. |
| Collection Trackers | Mobile and desktop apps that sync a collector's Discogs collection and wantlist offline. |
| Catalog Enrichment | Enrich third-party music libraries (DJ tools, archive systems, streaming metadata) with Discogs identifiers, formats, and release dates. |
| AI Music Agents | Power LLM-driven shopping, discovery, and collection-management agents via the Discogs MCP server ecosystem. |
| Research and Analytics | Use the monthly XML data dumps for population-level analysis of pressing variants, label catalogs, and marketplace pricing. |
| Name | Description |
|---|---|
| OAuth 1.0a | Standards-compliant OAuth 1.0a for delegated user authorization. |
| CSV | Bulk inventory imports and exports use CSV files. |
| Microcks | OpenAPI spec is annotated with x-microcks-operation extensions for mock-server compatibility. |
| Model Context Protocol | Five plus community MCP servers expose Discogs surfaces (search, collection, wantlist, marketplace) as MCP tools for LLM agents. |
| Name | Description |
|---|---|
| Marketplace Storefront Sync | Combine inventory upload, order management, and price suggestions to operate a multi-channel record store with Discogs as inventory of record. |
| Collector Mobile Companion | Combine identity, collection, wantlist, and search to build a fully-featured mobile companion for record collectors. |
| Catalog Resolution Service | Use search and release endpoints to resolve fuzzy track metadata into canonical Discogs IDs and master release versions. |
Machine-readable API specifications organized by format.
See json-schema/ — 55 schema files extracted from the OpenAPI components.
See json-structure/ — 55 JSON Structure files (json-structure.org meta).
See examples/ — 55 representative example payloads.
Self-contained Naftiko capability files (one per OpenAPI tag) with inline REST and MCP adapters.
| Capability | Consumed Operations | MCP Tools | File |
|---|---|---|---|
| Discogs API — Database | 12 | 12 | discogs-database.yaml |
| Discogs API — Image | 1 | 1 | discogs-image.yaml |
| Discogs API — Inventory Management | 9 | 9 | discogs-inventory-management.yaml |
| Discogs API — Marketplace | 14 | 14 | discogs-marketplace.yaml |
| Discogs API — User Collection | 4 | 4 | discogs-user-collection.yaml |
| Discogs API — User Identity | 5 | 5 | discogs-user-identity.yaml |
| Discogs API — User Lists | 2 | 2 | discogs-user-lists.yaml |
| Discogs API — User Wantlist | 3 | 3 | discogs-user-wantlist.yaml |
- discogs-vocabulary.yml — Unified taxonomy mapping operational (OpenAPI) and capability (Naftiko) dimensions.
- discogs-rules.yml — 35 Spectral rules enforcing Discogs API conventions.
FN: Kin Lane
Email: kin@apievangelist.com