Discogs API

Search the Discogs database and the Discogs marketplace and get releases, prices and sellers as clean JSON.

The API.SH Discogs API returns the public Discogs music database and marketplace as structured JSON. Search releases, masters, artists and labels by keyword, barcode, catalog number, genre, style, format, country or year; pull a release with its tracklist, credits, identifiers, community have and want counts, rating and lowest marketplace price; list every version of an album; and search items for sale with the same filters as the Discogs shop: condition, format, ships-from country, price range and seller.

Get a free API key Try it in the playground

13 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Discogs marketplace search

GET https://api.api.sh/discogs/v1/marketplace/search

{"query": "daft punk discovery","applied_filters": {"formatName": ["Vinyl"],"formatNameAnd": true,"priceRangeLow": 0,"priceRangeHigh": 100000},"available_only": true,"sort": "listed","order": "desc","country": "US","total": 491,"count": 25,"unavailable": 0,"next_cursor": "WzE3OTM1OTk1MjIwMDAsIDQwMzU1ODYyNDZd","facets": {"allowsOffers": [{"value": "true","count": 96}],"currency": [{"value": "EUR","count": 234},{"value": "USD","count": 125},"… 7 more"],"formatDescription": [{"value": "LP","count": 471},{"value": "Album","count": 469},"… 12 more"],"formatName": [{"value": "Vinyl","count": 491},{"value": "CD","count": 325},"… 5 more"],"genre": [{"value": "Electronic","count": 491},{"value": "Rock","count": 23},"… 3 more"],"hasInventoryImages": [{"value": "true","count": 1}],"hideGenericSleeves": [{"value": "true","count": 488}],"hideSleevelessMedia": [{"value": "true","count": 490}],"isDeal": [{"value": "true","count": 6}],"mediaCondition": [{"value": "Mint (M)","count": 316},{"value": "Near Mint (NM or M-)","count": 88},"… 5 more"],"shipsFrom": [{"value": "United States","count": 101},{"value": "United Kingdom","count": 94},"… 35 more"],"shipsFromRegion": [{"value": "European Union","count": 228},{"value": "North America","count": 114},"… 6 more"],"sleeveCondition": [{"value": "Mint (M)","count": 277},{"value": "Near Mint (NM or M-)","count": 114},"… 7 more"],"styleId": [{"value": "2","count": 465},{"value": "43","count": 384},"… 11 more"],"year": [{"value": "2001","count": 125},{"value": "2023","count": 114},"… 11 more"]},"price_buckets": {"price": [{"lower": null,"upper": "5","count": 0},{"lower": "5","upper": "25","count": 3},"… 3 more"],"year": [{"lower": "2000","upper": "2010","count": 132},{"lower": "2010","upper": "2020","count": 68},"… 1 more"]},"listings": [{"id": "4404689592","url": "https://www.discogs.com/sell/item/4404689592","media_condition": "VERY_GOOD_PLUS","sleeve_condition": "VERY_GOOD_PLUS","notes": "Excellent LPs. Well taken care of. Jacket has noticeable edge, shelf, and corner wear. Soft corners. Closer to VG- for the jacket. Shipped s…","listed": "2026-11-05T02:52:23-08:00","is_deal": false,"accepts_offers": false,"price": 70,"currency": "USD","buyer_price": 70,"buyer_currency": "USD","shipping_price": 0,"shipping_buyer_price": 0,"free_shipping_minimum": null,"available": true,"unavailable_reason": null,"photos": [],"seller": {"id": 4378055,"username": "GratefulVinyl","rating": 100,"ratings": 480,"ships_from": "United States","independent": false},"release": {"id": 10405650,"title": "Discovery","released": "2017","country": "France","artists": [{"…": "2 fields"}],"labels": [{"…": "3 fields"},{"…": "3 fields"}],"format": {"primaryFormat": "Vinyl","recordingTypes": ["Album"],"description": "2 x LP","issueType": "Reissue","__typename": "FormatSummary"},"thumbnail": "https://i.discogs.com/zMpzF9YaSeUE7pN0NiHKF5a_sHTKnM79W2T_VYmu9PY/rs:fit/g:sm/q:40/h:300/w:300/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTE…","url": "https://www.discogs.com/release/10405650"}},{"id": "4458001966","url": "https://www.discogs.com/sell/item/4458001966","media_condition": "MINT","sleeve_condition": "MINT","notes": "","listed": "2026-11-04T20:51:38+00:00","is_deal": false,"accepts_offers": false,"price": 36.98,"currency": "USD","buyer_price": 36.98,"buyer_currency": "USD","shipping_price": 6,"shipping_buyer_price": 6,"free_shipping_minimum": null,"available": true,"unavailable_reason": null,"photos": [],"seller": {"id": 2704137,"username": "CrookedArmVinylTap","rating": 99.7958,"ratings": 4932,"ships_from": "United States","independent": true},"release": {"id": 29277010,"title": "Discovery","released": "2023","country": "Europe","artists": [{"…": "2 fields"}],"labels": [{"…": "3 fields"}],"format": {"primaryFormat": "Vinyl","recordingTypes": ["Album"],"description": "2 x LP, Gatefold","issueType": "Reissue","__typename": "FormatSummary"},"thumbnail": "https://i.discogs.com/R_mVX-5otJuKFA3w9cSeTu2nuIltS4yUkWUVjAx48F0/rs:fit/g:sm/q:40/h:300/w:300/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTI…","url": "https://www.discogs.com/release/29277010"}},"… 23 more"],"cached": false,"credits_used": 1}

1 credit · $1 per 1,000 calls

What you can build with the Discogs API

Record collection and catalog apps

Look up releases by barcode or catalog number, then pull the tracklist, credits, labels and formats to fill a collection app or a shop catalog.

/search /release /master/versions

Vinyl price tracking

Track the lowest price and the number of copies for sale for a release, and search marketplace listings by media condition and price range to see what a pressing really sells for.

/release /marketplace/search

Reseller and dealer sourcing

Search the marketplace for underpriced copies by format, condition, ships-from country and price, sorted by price or newest, and check each seller's rating and shipping policy before you buy.

/marketplace/search /seller

Competitor inventory monitoring

Follow another record store's Discogs inventory, sorted by date listed or price, and pull single listings to compare condition, price and shipping.

/seller/inventory /marketplace/listing

Discography and label research

Build complete discographies from an artist's releases and roles, or list everything a label put out, for music journalism, archives and royalty research.

/artist /artist/releases /label /label/releases

Discogs data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Discogs artist/discogs/v1/artist

id125246nameNirvanaprofileRock/grunge band from Aberdeen, …data_qualityNeeds Voteurlhttps://www.discogs.com/artist/1…

aliases[]id · name · resource_url

members[]id · name · resource_url · active

Discogs artist releases/discogs/v1/artist/releases

artist_id125246page1per_page50total2255total_pages46next_page2count50

releases[]id · type · title · artist · role · year · format · label · main_release · stats · url

Discogs label/discogs/v1/label

id895nameRCAprofileMultinational label. Label Code…contact_info[u]US:[/u] 550 Broadway New Yo…data_qualityNeeds Voteurlhttps://www.discogs.com/label/89…

parent_label[]id · name · resource_url

sublabels[]id · name · resource_url

Discogs API endpoints and prices

Every Discogs endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

Discogs marketplace search /discogs/v1/marketplace/search params none required +29 optionaldocs try	$1 · $2 PAYG 1 credit
Discogs database search /discogs/v1/search params none required +20 optionaldocs try	$1 · $2 PAYG 1 credit

Profiles and accounts4

Discogs artist /discogs/v1/artist params iddocs try	$1 · $2 PAYG 1 credit
Discogs artist releases /discogs/v1/artist/releases params id +4 optionaldocs try	$1 · $2 PAYG 1 credit
Discogs seller /discogs/v1/seller params usernamedocs try	$1 · $2 PAYG 1 credit
Discogs seller inventory /discogs/v1/seller/inventory params username +4 optionaldocs try	$1 · $2 PAYG 1 credit

Products, listings and places1

Discogs marketplace listing

/discogs/v1/marketplace/listing

params none required +4 optionaldocstry

$1 · $2 PAYG

1 credit

More data6

Discogs label /discogs/v1/label params iddocs try	$1 · $2 PAYG 1 credit
Discogs label releases /discogs/v1/label/releases params id +2 optionaldocs try	$1 · $2 PAYG 1 credit
Discogs list /discogs/v1/list params iddocs try	$1 · $2 PAYG 1 credit
Discogs master release /discogs/v1/master params iddocs try	$1 · $2 PAYG 1 credit
Discogs master versions /discogs/v1/master/versions params id +8 optionaldocs try	$1 · $2 PAYG 1 credit
Discogs release /discogs/v1/release params id +1 optionaldocs try	$1 · $2 PAYG 1 credit

Call the Discogs API

Discogs marketplace search: GET https://api.api.sh/discogs/v1/marketplace/search

curl "https://api.api.sh/discogs/v1/marketplace/search?q=daft+punk+discovery&format=Vinyl" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/discogs/v1/marketplace/search",
    params={"q": "daft punk discovery", "format": "Vinyl"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/discogs/v1/marketplace/search");
url.searchParams.set("q", "daft punk discovery");
url.searchParams.set("format", "Vinyl");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/discogs/v1/marketplace/search", "q", "daft punk discovery", "format", "Vinyl")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Discogs" and "Discogs marketplace search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 902 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Discogs data

Public data only: no Discogs login, cookies or account needed
One key and one response shape for Discogs and 901 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
No rate limits: run as many calls in parallel as you need
Live status for every endpoint

API.SH vs the official Discogs API

Discogs has an official, free developer API for its database and for managing your own collection and listings. It asks for a personal token or OAuth for search and image links, and it does not offer a search of the whole marketplace. API.SH needs no Discogs account or token, adds marketplace search with the shop's filters and seller shipping policies, and returns the same JSON shape as every other API.SH platform.

Instead of registering an app, handling tokens and rate limits, or writing a scraper for marketplace pages, use one API.SH key with a fixed price per call.

Discogs API questions

What Discogs data can I get?+

Database search (/discogs/v1/search), releases (/discogs/v1/release), masters and their versions (/discogs/v1/master, /discogs/v1/master/versions), artists and their releases (/discogs/v1/artist, /discogs/v1/artist/releases), labels and their releases (/discogs/v1/label, /discogs/v1/label/releases), marketplace search and single listings (/discogs/v1/marketplace/search, /discogs/v1/marketplace/listing), seller profiles and inventories (/discogs/v1/seller, /discogs/v1/seller/inventory) and public lists (/discogs/v1/list).

How much does the Discogs API cost?+

Every Discogs endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /discogs/v1/artist at 1 credit each.

Is there an official Discogs API?+

Yes. Discogs runs a free developer API; search and image links need a personal token or OAuth, and it is built around your own account's collection and listings. API.SH needs no Discogs token and adds a search of the whole marketplace with the shop's filters.

Do I need a Discogs account or API token?+

No. API.SH reads public Discogs data only. No endpoint uses a login, a token or anyone's account.

Can I get Discogs marketplace prices?+

Yes. /discogs/v1/release returns the number of copies for sale and the lowest price in the currency you choose, and /discogs/v1/marketplace/search returns each listing's price, shipping, condition and seller, with filters for condition, format, price range and ships-from country.

Can I use the Discogs API from Python?+

Yes. Every endpoint is a plain HTTPS GET that returns JSON, so requests, httpx or the API.SH Python SDK all work. Pass your key in the x-api-key header.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /discogs/v1/release with a release id or link, or /discogs/v1/marketplace/search with a keyword. Every parameter is in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Does the Discogs API have a rate limit?+

No. API.SH puts no rate limit on your key: send as many Discogs calls in parallel as you need and pay only for the calls that run. If Discogs itself slows down, the call returns 503 with a retry-after header and is not charged.