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.

🌐 Visit website 📡 Source on GitHub

43.2/100 developing ▬ flat Agent 33/100 agent ready saas Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessFreemiumSelf serve⚡ Free to try

8 APIs

Music Marketplace Catalog Community Vinyl Public APIs

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 43.2/100 · developing

Contract Quality 7.4 / 23

Developer Ergonomics 9.4 / 18

Access Clarity 5.7 / 18

Operational Transparency 4.0 / 12

Contract Governance 3.1 / 11

Discoverability 7.3 / 9

Create-or-Update Ergonomics 2.8 / 10

Agent readiness — 33/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

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

Delegated User Identity 6 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/discogs: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

Discogs Database API

Access Discogs database: artists, releases, masters, labels, and search.

Discogs Image API

Image asset retrieval (proxied via OAuth).

Discogs Inventory Management API

Bulk inventory export and CSV upload management.

Discogs Marketplace API

Marketplace listings, orders, fees, price suggestions, and release stats.

Discogs User Collection API

Manage a user's record collection.

Discogs User Identity API

Authenticated user identity, profile, submissions, and contributions.

Discogs User Lists API

Browse and manage user-created lists of releases, artists, and labels.

Discogs User Wantlist API

Manage a user's wantlist.

Scroll for all 8

Open Collections 9

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Discogs Database API

OPEN COLLECTION

Discogs Database Image API

OPEN COLLECTION

Discogs Database Inventory Management API

OPEN COLLECTION

Discogs Database Marketplace API

OPEN COLLECTION

Discogs Database User Collection API

OPEN COLLECTION

Discogs Database User Identity API

OPEN COLLECTION

Discogs Database User Lists API

OPEN COLLECTION

Discogs Database User Wantlist API

OPEN COLLECTION

Scroll for all 9

GraphQL 1

GraphQL schemas published by this provider.

Discogs GraphQL Schema

This document describes a conceptual GraphQL schema for the Discogs API. Discogs is a community-built music database and marketplace for physical music releases (vinyl, CD, cass...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Discogs Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Discogs Rate Limits

3 limits

RATE LIMITS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Discogs Context

49 classes · 159 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Discogs API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Discogs API Rules

35 rules · 11 errors 19 warnings 5 info

SPECTRAL

JSON Schema 55

Standalone JSON Schema definitions for this provider's data models.

ArtistRelease

11 properties

JSON SCHEMA

Artist

12 properties

JSON SCHEMA

ArtistSummary

7 properties

JSON SCHEMA

CollectionFolder

4 properties

JSON SCHEMA

CollectionRelease

6 properties

JSON SCHEMA

Community

7 properties

JSON SCHEMA

Contribution

2 properties

JSON SCHEMA

Currency

0 properties

JSON SCHEMA

Fee

2 properties

JSON SCHEMA

Identifier

3 properties

JSON SCHEMA

Identity

4 properties

JSON SCHEMA

Image

6 properties

JSON SCHEMA

InventoryExport

8 properties

JSON SCHEMA

InventoryExportsResponse

2 properties

JSON SCHEMA

InventoryUpload

7 properties

JSON SCHEMA

InventoryUploadsResponse

2 properties

JSON SCHEMA

LabelRelease

9 properties

JSON SCHEMA

Label

12 properties

JSON SCHEMA

LabelSummary

5 properties

JSON SCHEMA

ListItem

7 properties

JSON SCHEMA

List

11 properties

JSON SCHEMA

ListingNew

11 properties

JSON SCHEMA

ListingRelease

9 properties

JSON SCHEMA

Listing

18 properties

JSON SCHEMA

ListingUpdate

0 properties

JSON SCHEMA

ListsResponse

2 properties

JSON SCHEMA

Master

0 properties

JSON SCHEMA

MediaCondition

0 properties

JSON SCHEMA

OrderMessage

7 properties

JSON SCHEMA

OrderMessagesResponse

2 properties

JSON SCHEMA

Order

17 properties

JSON SCHEMA

OrdersResponse

2 properties

JSON SCHEMA

Pagination

5 properties

JSON SCHEMA

Price

2 properties

JSON SCHEMA

PriceSuggestion

2 properties

JSON SCHEMA

PriceSuggestionsResponse

0 properties

JSON SCHEMA

Profile

30 properties

JSON SCHEMA

ProfileUpdate

5 properties

JSON SCHEMA

ReleaseFormat

4 properties

JSON SCHEMA

ReleaseRating

2 properties

JSON SCHEMA

Release

31 properties

JSON SCHEMA

ReleaseStats

3 properties

JSON SCHEMA

ReleaseSummary

11 properties

JSON SCHEMA

ReleaseVersion

12 properties

JSON SCHEMA

SearchResultArtist

0 properties

JSON SCHEMA

SearchResultLabel

0 properties

JSON SCHEMA

SearchResultMaster

0 properties

JSON SCHEMA

SearchResultRelease

15 properties

JSON SCHEMA

SleeveCondition

0 properties

JSON SCHEMA

Submission

2 properties

JSON SCHEMA

Track

5 properties

JSON SCHEMA

UserReleaseRating

3 properties

JSON SCHEMA

UserSummary

3 properties

JSON SCHEMA

Video

5 properties

JSON SCHEMA

Want

5 properties

JSON SCHEMA

Scroll for all 55

JSON Structure 55

JSON Structure definitions describing this provider's data shapes.

Discogs Artist Release Structure

11 properties

JSON STRUCTURE

Discogs Artist Structure

12 properties

JSON STRUCTURE

Discogs Artist Summary Structure

7 properties

JSON STRUCTURE

Discogs Collection Folder Structure

4 properties

JSON STRUCTURE

Discogs Collection Release Structure

6 properties

JSON STRUCTURE

Discogs Community Structure

7 properties

JSON STRUCTURE

Discogs Contribution Structure

2 properties

JSON STRUCTURE

Discogs Currency Structure

0 properties

JSON STRUCTURE

Discogs Fee Structure

2 properties

JSON STRUCTURE

Discogs Identifier Structure

3 properties

JSON STRUCTURE

Discogs Identity Structure

4 properties

JSON STRUCTURE

Discogs Image Structure

6 properties

JSON STRUCTURE

Discogs Inventory Export Structure

8 properties

JSON STRUCTURE

Discogs Inventory Exports Response Structure

2 properties

JSON STRUCTURE

Discogs Inventory Upload Structure

7 properties

JSON STRUCTURE

Discogs Inventory Uploads Response Structure

2 properties

JSON STRUCTURE

Discogs Label Release Structure

9 properties

JSON STRUCTURE

Discogs Label Structure

12 properties

JSON STRUCTURE

Discogs Label Summary Structure

5 properties

JSON STRUCTURE

Discogs List Item Structure

7 properties

JSON STRUCTURE

Discogs List Structure

11 properties

JSON STRUCTURE

Discogs Listing New Structure

11 properties

JSON STRUCTURE

Discogs Listing Release Structure

9 properties

JSON STRUCTURE

Discogs Listing Structure

18 properties

JSON STRUCTURE

Discogs Listing Update Structure

0 properties

JSON STRUCTURE

Discogs Lists Response Structure

2 properties

JSON STRUCTURE

Discogs Master Structure

0 properties

JSON STRUCTURE

Discogs Media Condition Structure

0 properties

JSON STRUCTURE

Discogs Order Message Structure

7 properties

JSON STRUCTURE

Discogs Order Messages Response Structure

2 properties

JSON STRUCTURE

Discogs Order Structure

17 properties

JSON STRUCTURE

Discogs Orders Response Structure

2 properties

JSON STRUCTURE

Discogs Pagination Structure

5 properties

JSON STRUCTURE

Discogs Price Structure

2 properties

JSON STRUCTURE

Discogs Price Suggestion Structure

2 properties

JSON STRUCTURE

Discogs Price Suggestions Response Structure

0 properties

JSON STRUCTURE

Discogs Profile Structure

30 properties

JSON STRUCTURE

Discogs Profile Update Structure

5 properties

JSON STRUCTURE

Discogs Release Format Structure

4 properties

JSON STRUCTURE

Discogs Release Rating Structure

2 properties

JSON STRUCTURE

Discogs Release Stats Structure

3 properties

JSON STRUCTURE

Discogs Release Structure

31 properties

JSON STRUCTURE

Discogs Release Summary Structure

11 properties

JSON STRUCTURE

Discogs Release Version Structure

12 properties

JSON STRUCTURE

Discogs Search Result Artist Structure

0 properties

JSON STRUCTURE

Discogs Search Result Label Structure

0 properties

JSON STRUCTURE

Discogs Search Result Master Structure

0 properties

JSON STRUCTURE

Discogs Search Result Release Structure

15 properties

JSON STRUCTURE

Discogs Sleeve Condition Structure

0 properties

JSON STRUCTURE

Discogs Submission Structure

2 properties

JSON STRUCTURE

Discogs Track Structure

5 properties

JSON STRUCTURE

Discogs User Release Rating Structure

3 properties

JSON STRUCTURE

Discogs User Summary Structure

3 properties

JSON STRUCTURE

Discogs Video Structure

5 properties

JSON STRUCTURE

Discogs Want Structure

5 properties

JSON STRUCTURE

Scroll for all 55

Examples 49

Example request and response payloads for these APIs.

Discogs Artist Example

12 fields

EXAMPLE

Discogs Artist Release Example

11 fields

EXAMPLE

Discogs Artist Summary Example

7 fields

EXAMPLE

Discogs Collection Folder Example

4 fields

EXAMPLE

Discogs Collection Release Example

6 fields

EXAMPLE

Discogs Community Example

7 fields

EXAMPLE

Discogs Contribution Example

2 fields

EXAMPLE

Discogs Fee Example

2 fields

EXAMPLE

Discogs Identifier Example

3 fields

EXAMPLE

Discogs Identity Example

4 fields

EXAMPLE

Discogs Image Example

6 fields

EXAMPLE

Discogs Inventory Export Example

8 fields

EXAMPLE

Discogs Inventory Exports Response Example

2 fields

EXAMPLE

Discogs Inventory Upload Example

7 fields

EXAMPLE

Discogs Inventory Uploads Response Example

2 fields

EXAMPLE

Discogs Label Example

12 fields

EXAMPLE

Discogs Label Release Example

9 fields

EXAMPLE

Discogs Label Summary Example

5 fields

EXAMPLE

Discogs List Example

11 fields

EXAMPLE

Discogs List Item Example

7 fields

EXAMPLE

Discogs Listing Example

18 fields

EXAMPLE

Discogs Listing New Example

11 fields

EXAMPLE

Discogs Listing Release Example

9 fields

EXAMPLE

Discogs Listing Update Example

0 fields

EXAMPLE

Discogs Lists Response Example

2 fields

EXAMPLE

Discogs Master Example

0 fields

EXAMPLE

Discogs Order Example

17 fields

EXAMPLE

Discogs Order Message Example

7 fields

EXAMPLE

Discogs Order Messages Response Example

2 fields

EXAMPLE

Discogs Orders Response Example

2 fields

EXAMPLE

Discogs Pagination Example

5 fields

EXAMPLE

Discogs Price Example

2 fields

EXAMPLE

Discogs Price Suggestion Example

2 fields

EXAMPLE

Discogs Price Suggestions Response Example

0 fields

EXAMPLE

Discogs Profile Example

30 fields

EXAMPLE

Discogs Profile Update Example

5 fields

EXAMPLE

Discogs Release Example

31 fields

EXAMPLE

Discogs Release Format Example

4 fields

EXAMPLE

Discogs Release Rating Example

2 fields

EXAMPLE

Discogs Release Stats Example

3 fields

EXAMPLE

Discogs Release Summary Example

11 fields

EXAMPLE

Discogs Release Version Example

12 fields

EXAMPLE

Discogs Search Result Release Example

15 fields

EXAMPLE

Discogs Submission Example

2 fields

EXAMPLE

Discogs Track Example

5 fields

EXAMPLE

Discogs User Release Rating Example

3 fields

EXAMPLE

Discogs User Summary Example

3 fields

EXAMPLE

Discogs Video Example

5 fields

EXAMPLE

Discogs Want Example

5 fields

EXAMPLE

Scroll for all 49

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Discogs Authentication

apiKey/oauth2 · 2 schemes

SECURITY

Discogs Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Discogs Scopes

2 scopes · authorizationCode

2 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Discogs Agentic Access

50 operations · 16 acting

AGENTIC

Resources

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Vocabulary

Vocabulary

SpectralRuleset

SpectralRuleset

JSONLDContext

JSONLDContext

Build 6

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

MCP Server (cswkim)

Tools

MCP Server (rianvdm OAuth)

Tools

MCP Server (pipeworx-io)

Tools

MCP Server (andylobban Self-hostable)

Tools

MCP Server (leosakharoff)

Tools

Access & Security 4

Authentication, authorization, and security posture

DomainSecurity

Authentication

OAuthScopes

Authentication

Operate 4

Status, limits, changes, and where to get help

Support

Forums

Status

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

Plans

Plans

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 2

Properties that don't map to a standard resource type

PublicAPIsListing

PublicAPIsListing

Monthly XML Data Dumps

BulkData

Source (apis.yml)

aid: discogs
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
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.23'
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

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/discogs"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/discogs/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/discogs/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.