Home
Providers
Discogs
Discogs
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.
Discogs publishes 8 APIs on the APIs.io network, including Database API, Image API, Inventory Management API, and 5 more. Tagged areas include Music, Marketplace, Catalog, Community, and Vinyl.
The Discogs catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Discogs’ developer surface includes authentication, documentation, API reference, support, status page, engineering blog, tooling, and 19 more developer resources.
8 APIs
Music Marketplace Catalog Community Vinyl Public APIs
On this page
Kin Score
APIs 8
GraphQL 1
Pricing Plans 1
Rate Limits 1
Vocabularies 1
Spectral Rules 2
JSON Schema 55
JSON Structure 55
Examples 49
Security Posture 2
Scopes 1
Agentic Access 1
Resources 26
apis.yml
37 Operational Transparency
Composite quality — 50.1/100 · developing
Contract Quality
16.1 / 25
Developer Ergonomics
6.5 / 20
Commercial Clarity
6.3 / 20
Operational Transparency
4.8 / 13
Agent readiness — 44/100 · agent ready
Machine-Readable Contract
18 / 18
Agentic Access Contract
10 / 10
MCP Server
0 / 12
Machine-Readable Auth
10 / 10
Idempotency
0 / 9
Stable Error Semantics
8 / 8
Request/Response Examples
7 / 7
Rate-Limit Signaling
7 / 7
Typed Event Surface
0 / 6
Agent Skills
0 / 5
Well-Known Catalog
0 / 4
Consent & Bot Identity
0 / 3
A2A Agent Card
0 / 8
Dry-Run / Simulate Mode
0 / 4
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 8
GraphQL schemas published by this provider.
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
Scroll for all 55
JSON Structure definitions describing this provider's data shapes.
Scroll for all 55
Example request and response payloads for these APIs.
Scroll for all 49
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 3
Pagination, idempotency, versioning, errors, and events
Build 6
SDKs, sample code, and the tooling you integrate with
Access & Security 4
Authentication, authorization, and security posture
Operate 4
Status, limits, changes, and where to get help
Commercial 2
Pricing, plans, and the legal terms of use
Company 2
The organization behind the API
Other 2
Properties that don't map to a standard resource type
Source (apis.yml)
aid: discogs
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
label: Freemium · Self-serve signup
confidence: high
source:
- plans
- authentication
generated: '2026-07-22'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/discogs.png
name: Discogs
description: '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: https://www.discogs.com/developers/
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-category: Music
x-tier: 2
x-tier-reason: Catalog + marketplace platform with a public REST API, OAuth1, well-documented endpoints, multiple community
SDKs, and an active MCP ecosystem.
tags:
- Music
- Marketplace
- Catalog
- Community
- Vinyl
- Public APIs
apis:
- aid: discogs:discogs-database-api
name: Discogs Database API
description: 'Access Discogs database: artists, releases, masters, labels, and search.'
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- Database
properties:
- type: OpenAPI
url: openapi/discogs-database-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
- aid: discogs:discogs-image-api
name: Discogs Image API
description: Image asset retrieval (proxied via OAuth).
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- Image
properties:
- type: OpenAPI
url: openapi/discogs-image-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
- aid: discogs:discogs-inventory-management-api
name: Discogs Inventory Management API
description: Bulk inventory export and CSV upload management.
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- Inventory Management
properties:
- type: OpenAPI
url: openapi/discogs-inventory-management-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
- aid: discogs:discogs-marketplace-api
name: Discogs Marketplace API
description: Marketplace listings, orders, fees, price suggestions, and release stats.
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- Marketplace
properties:
- type: OpenAPI
url: openapi/discogs-marketplace-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-collection-api
name: Discogs User Collection API
description: Manage a user's record collection.
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- User Collection
properties:
- type: OpenAPI
url: openapi/discogs-user-collection-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-identity-api
name: Discogs User Identity API
description: Authenticated user identity, profile, submissions, and contributions.
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- User Identity
properties:
- type: OpenAPI
url: openapi/discogs-user-identity-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-lists-api
name: Discogs User Lists API
description: Browse and manage user-created lists of releases, artists, and labels.
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- User Lists
properties:
- type: OpenAPI
url: openapi/discogs-user-lists-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-wantlist-api
name: Discogs User Wantlist API
description: Manage a user's wantlist.
humanURL: https://www.discogs.com/developers
baseURL: https://api.discogs.com
tags:
- User Wantlist
properties:
- type: OpenAPI
url: openapi/discogs-user-wantlist-api-openapi.yml
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: SDKs
url: https://github.com/joalla/discogs_client
- type: SDKs
url: https://github.com/jmfontaine/discogs-sdk
- type: SDKs
url: https://github.com/andy-miles/discogs-java-client
- type: SDKs
url: https://github.com/rock-n-code/discogs-service
- type: SDKs
url: https://github.com/discogs/discogs_client
- type: BulkData
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: GraphQL
url: graphql/discogs-graphql.md
common:
- type: AgenticAccess
url: agentic-access/discogs-agentic-access.yml
- type: DomainSecurity
url: security/discogs-domain-security.yml
- type: Authentication
url: authentication/discogs-authentication.yml
- type: OAuthScopes
url: scopes/discogs-scopes.yml
- type: Website
url: https://www.discogs.com
- type: Documentation
url: https://www.discogs.com/developers
- type: APIReference
url: https://www.discogs.com/developers
- type: TermsOfService
url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: Authentication
url: https://www.discogs.com/developers#page:authentication
- type: Support
url: https://support.discogs.com
- type: Forums
url: https://www.discogs.com/forum/topic/1082
- type: Status
url: https://status.discogs.com
- type: Blog
url: https://blog.discogs.com
- type: Plans
url: plans/discogs-plans-pricing.yml
- type: RateLimits
url: rate-limits/discogs-rate-limits.yml
- type: GitHubOrganization
url: https://github.com/discogs
- type: PublicAPIsListing
url: https://github.com/public-apis/public-apis
- type: BulkData
title: Monthly XML Data Dumps
url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: Tools
title: MCP Server (cswkim)
url: https://github.com/cswkim/discogs-mcp-server
- type: Tools
title: MCP Server (rianvdm OAuth)
url: https://github.com/rianvdm/discogs-mcp
- type: Tools
title: MCP Server (pipeworx-io)
url: https://github.com/pipeworx-io/mcp-discogs
- type: Tools
title: MCP Server (andylobban Self-hostable)
url: https://github.com/andylobban/discogs-mcp-server
- type: Tools
title: MCP Server (leosakharoff)
url: https://github.com/leosakharoff/discogs-mcp
- type: Vocabulary
url: vocabulary/discogs-vocabulary.yml
- type: SpectralRuleset
url: rules/discogs-rules.yml
- type: JSONLDContext
url: json-ld/discogs-context.jsonld
features:
- name: Database Search
description: Free-text search across releases, masters, artists, and labels with rich filters (year, country, format, label,
genre, style, barcode, catno).
- name: Release Catalog
description: Detailed release records including tracks, formats, labels, artists, videos, identifiers, community stats,
and marketplace stats.
- name: User Collection Management
description: Read and modify user record collections, organized into custom folders with notes and rating per copy.
- name: User Wantlist
description: Track wanted releases, with notes and ratings; add and remove releases programmatically.
- name: Marketplace Listings
description: List, update, and delete records for sale; query inventory by username; integrate with checkout flows via the
Listing endpoints.
- name: Marketplace Orders
description: Inspect, update, and message on orders the authenticated seller has received.
- name: Price Suggestions
description: Get Discogs-calculated suggested marketplace prices by release and media condition.
- name: Bulk Inventory Management
description: CSV-driven bulk add, change, and delete of inventory listings via asynchronous upload jobs; full inventory
export to CSV.
- name: OAuth 1.0a
description: Three-legged OAuth 1.0a flow for building third-party apps that act on behalf of other Discogs users.
- name: Monthly XML Data Dumps
description: Discogs publishes a monthly snapshot of the full database (artists, labels, masters, releases) as XML on S3
for bulk analysis.
useCases:
- name: Music Discovery Apps
description: Build apps that surface release metadata, cover art, video links, community ratings, and label discographies.
- name: Vinyl Reseller Tools
description: Power inventory management, pricing, and order workflows for vinyl resellers selling on the Discogs Marketplace.
- name: Collection Trackers
description: Mobile and desktop apps that sync a collector's Discogs collection and wantlist offline.
- name: Catalog Enrichment
description: Enrich third-party music libraries (DJ tools, archive systems, streaming metadata) with Discogs identifiers,
formats, and release dates.
- name: AI Music Agents
description: Power LLM-driven shopping, discovery, and collection-management agents via the Discogs MCP server ecosystem.
- name: Research and Analytics
description: Use the monthly XML data dumps for population-level analysis of pressing variants, label catalogs, and marketplace
pricing.
integrations:
- name: OAuth 1.0a
description: Standards-compliant OAuth 1.0a for delegated user authorization.
- name: CSV
description: Bulk inventory imports and exports use CSV files.
- name: Microcks
description: OpenAPI spec is annotated with x-microcks-operation extensions for mock-server compatibility.
- name: Model Context Protocol
description: Five plus community MCP servers expose Discogs surfaces (search, collection, wantlist, marketplace) as MCP
tools for LLM agents.
solutions:
- name: Marketplace Storefront Sync
description: Combine inventory upload, order management, and price suggestions to operate a multi-channel record store with
Discogs as inventory of record.
- name: Collector Mobile Companion
description: Combine identity, collection, wantlist, and search to build a fully-featured mobile companion for record collectors.
- name: Catalog Resolution Service
description: Use search and release endpoints to resolve fuzzy track metadata into canonical Discogs IDs and master release
versions.
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com