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 is listed with 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 📡 Profile data on GitHub

36.6/100 thin ▬ flat Agent 33/100 agent ready Heartbeat 50/100 alive saas Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →

AccessFreemiumSelf serve⚡ Free to try

8 APIs

Music Marketplace Catalog Community Vinyl Public APIs

Kin Score

Kin Score How this is scored →
scored 2026-11-06 · rubric v0.27.0

Composite quality — 36.6/100 · thin

Contract Quality 4.6 / 19

Developer Ergonomics 7.9 / 15

Access Clarity 2.4 / 15

Operational Transparency 1.0 / 10

Contract Governance 2.5 / 9

Discoverability 5.9 / 8

Regulatory Posture 4.6 / 15

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

Pagination 5 / 5

Distinct Operations 3 / 3

MCP Tool Quality 6 / 6

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

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.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Show this score on your site.

It updates itself when the score changes. Paste this where you link to your API docs:

<a href="https://apis.io/providers/discogs/"><img src="https://apis.io/badge/discogs/card.svg" alt="Discogs on APIs.io — Kin Score by API Evangelist"></a>

Other styles, a README pill and a shields.io endpoint are on the badge page.

Raise your score.

Agent readiness — checks not met, largest first (exact, from this profile):

MCP Server +12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship
Idempotency +9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card +8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Registration Without a Human +6 pts — a `registration_endpoint` in the served RFC 8414 / OIDC discovery document
Typed Event Surface +6 pts — AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks
Documented Reversibility +6 pts — a reversal operation in the contract, graded up when a window is documented too

6 more unmet checks in the Agent Readiness table above.

Kin Score — facets with the most composite points still available (weight × headroom):

Contract Quality scores 24.4 — up to +18.9 composite points
Access Clarity scores 15.8 — up to +16.8 composite points
Operational Transparency scores 10.5 — up to +11.6 composite points

Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.

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 the provider profile at artifacts.apis.io/discogs/apis.yml: open an issue on github.com/api-evangelist/discogs to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

Market	Position	Depth	Registered MCP server	Declares compatibility
Music and Rights	covered	14.6	-	-
Raycast Store Extensions (first-party publishers + community-wrapped products)	covered	14.6	-	-
Obsidian Community Plugins (third-party APIs the Obsidian plugin ecosystem integrates)	covered	14.6	-	-

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 2

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

OpenAPI

measured — observed by APIs.io (published)

OAuth 2.0

measured — observed by APIs.io (declared)

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 8

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

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 8

Discogs API pricing

Not yet checked against Discogs's own pricing page. Compiled by API Evangelist on 2026-05-29 from www.discogs.com/developers; confirm before you rely on a figure. A free plan or tier is listed.

Plan	Price
API Access (Free) freemium	Free
Marketplace Sales usage-based	—

Plan details, limits and sources →

Rate limits

Authenticated requests (Discogs token, key+secret, or OAuth 1.0a): 60 requests per minute
Unauthenticated requests: 25 requests per minute
Image asset retrieval (OAuth-signed): 1000 requests per minute

Compiled by API Evangelist, not yet checked against Discogs's documentation. Rate-limit details →

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

Service Levels 1

Uptime the provider promises or reports, as SLA4OAI. Read from its own pages; APIs.io runs no monitors.

Discogs

SLA

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 — jsonschema 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

3 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

1 properties

JSON SCHEMA

SearchResultLabel

1 properties

JSON SCHEMA

SearchResultMaster

2 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
  gated: none
  gated_source:
  - onboarding
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-11-06'
  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
- 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
- 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
  tags_raw:
  - 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
- 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
- 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
- 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
- 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
- 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
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

Discogs API — frequently asked questions

Does Discogs have an API?

Yes. APIs.io lists 8 APIs from Discogs, including Discogs Database API, Discogs Image API and Discogs Inventory Management API, and 5 more.

Is there an OpenAPI specification for the Discogs API?

Yes. APIs.io indexes 8 OpenAPI specifications for Discogs, each linked for download from this page.

How do I authenticate with the Discogs API?

Discogs uses bearer-token authentication (apiKey/oauth2 · 2 schemes). The details are profiled on APIs.io as Discogs Authentication.

How much does the Discogs API cost?

APIs.io lists 2 pricing plans for Discogs, with each plan's price, limits and inclusions under Pricing on this page.

Is the Discogs API ready for AI agents?

Discogs has a Kin Score of 36.6 out of 100 (thin) and an Agent Readiness score of 32.9 (agent-ready), scored by API Evangelist on 2026-11-06.

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"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.