Discogs marketplace search
GET https://api.api.sh/discogs/v1/marketplace/search
Items for sale in the Discogs marketplace, with every filter the shop offers: keywords, a release, master, artist, label or seller, format and format details, genre, style, media and sleeve condition, ships-from country, listing currency, price range, release year range, deals, offers, photos and sleeve options; sorted by date listed, price, condition, artist, title or seller. Each listing: id, link, media and sleeve condition, seller notes, listed date, price and currency, price and shipping in the buyer's currency, availability, photos, seller (username, rating, ratings count, ships from) and the release (id, title, artists, labels with catalog numbers, format, country, released, thumbnail), with the record in raw. Also returns total, the facet counts for every filter and price buckets. By default only listings a buyer in country can purchase are returned, priced up to 100,000 in the buyer's currency (the shop's limit); available_only=false also counts the others, which the shop does not describe, in unavailable. Pass next_cursor back as cursor; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Discogs API: 13 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
q | string | Keywords (or a filter below; at least one is needed). Example: daft punk discovery |
release | string | Release id(s), comma separated. |
master | string | Master id(s). |
artist | string | Artist id(s). |
label | string | Label id(s). |
seller | string | Seller username(s) or id(s), comma separated. |
format | string | Format name(s), e.g. Vinyl, CD, Cassette. |
format_description | string | e.g. LP, Album, 7\", Reissue. |
genre | string | Genre name(s). |
style | string | Style name(s). |
media_condition | string | Condition(s): m, nm, vg+, vg, g+, g, f, p (comma separated). |
sleeve_condition | string | Sleeve condition(s): m, nm, vg+, vg, g+, g, f, p, generic, no cover, not graded. |
ships_from | string | Country name(s), e.g. Germany, United States. |
currency | string | Listing currency code(s), e.g. EUR, GBP. |
price_min | number | Price min. |
price_max | number | Price max. |
year_min | integer | Year min. |
year_max | integer | Year max. |
deals | boolean | Only listings the site marks as a good deal. |
offers | boolean | Only listings that accept offers. |
with_photos | boolean | Only listings with the seller's own photos. |
hide_sleeveless | boolean | Hide sleeveless. |
hide_generic_sleeves | boolean | Hide generic sleeves. |
sort | listed | price | condition | artist | title | seller | Sort field (default listed). |
order | asc | desc | Sort order (default desc for listed, price and condition). |
country | string | Buyer's country (2 letters, default US): prices and shipping are shown for it. |
available_only | boolean | Default true: only listings a buyer in country can purchase. false: count the rest in unavailable (their details are not served). |
limit | integer | Listings per page (25, 50 or 100; default 25). |
cursor | string | next_cursor from the previous page. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
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(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"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}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.