Discogs seller inventory
GET https://api.api.sh/discogs/v1/seller/inventory
A seller's items for sale, each with condition, price, shipping, ships from, comments, posted date and the release. Sort by date listed, price, item, artist, label, catalog number, audio, status or location. Pass next_page back as page; 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 |
|---|---|---|
usernamerequired | string | Username or a discogs.com/seller/<name> link. Example: mach1ne |
sort | listed | price | item | artist | label | catno | audio | status | location | Sort field. |
order | asc | desc | Sort order. |
limit | integer | Results per page (1-100, default 50). |
page | integer | Page number (1-based). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/discogs/v1/seller/inventory?username=mach1ne" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/discogs/v1/seller/inventory",
params={"username": "mach1ne"},
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/seller/inventory");
url.searchParams.set("username", "mach1ne");
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)
{"username": "mach1ne","page": 1,"per_page": 50,"total": 267,"total_pages": 6,"next_page": 2,"count": 50,"listings": [{"id": 1094282070,"status": "For Sale","condition": "Mint (M)","sleeve_condition": "Mint (M)","comments": "Unplayed spare copy. MINT. Please see my feedback for accurate grading and fast shipment.","price": 7,"currency": "GBP","original_price": {"curr_abbr": "GBP","curr_id": 2,"formatted": "£7.00","value": 7},"shipping_price": {},"original_shipping_price": {},"ships_from": "United Kingdom","allow_offers": false,"posted": "2021-12-26T01:00:29-08:00","audio": false,"location": null,"weight": null,"format_quantity": null,"seller": {"id": 46488,"username": "mach1ne","rating": "100.0","stars": 5,"total_ratings": 1323,"min_order_total": 0,"shipping": "Items are mailed on same or following day of receipt of payment and proofs of postage retained for each individual item - please check my fe…","payment": "PayPal Commerce","url": "https://www.discogs.com/user/mach1ne"},"release": {"id": 6438970,"description": "Tim Love Lee* - Tingle / E7000 (12\", Single)","artist": "Tim Love Lee*","title": "Tingle / E7000","format": "12\", Single","year": 2014,"catalog_number": "PAX2021","url": "https://www.discogs.com/release/6438970"},"url": "https://www.discogs.com/sell/item/1094282070"},{"id": 1093067101,"status": "For Sale","condition": "Mint (M)","sleeve_condition": "Mint (M)","comments": "Still sealed. Amazing album!!! Selling my spare copy.","price": 4,"currency": "GBP","original_price": {"curr_abbr": "GBP","curr_id": 2,"formatted": "£4.00","value": 4},"shipping_price": {},"original_shipping_price": {},"ships_from": "United Kingdom","allow_offers": false,"posted": "2021-12-26T01:00:29-08:00","audio": false,"location": null,"weight": null,"format_quantity": null,"seller": {"id": 46488,"username": "mach1ne","rating": "100.0","stars": 5,"total_ratings": 1323,"min_order_total": 0,"shipping": "Items are mailed on same or following day of receipt of payment and proofs of postage retained for each individual item - please check my fe…","payment": "PayPal Commerce","url": "https://www.discogs.com/user/mach1ne"},"release": {"id": 1489504,"description": "Sargasso Trio - Burnin' Burnin' Burnin' (CD, Album)","artist": "Sargasso Trio","title": "Burnin' Burnin' Burnin'","format": "CD, Album","year": 2007,"catalog_number": "DIB008CD","url": "https://www.discogs.com/release/1489504"},"url": "https://www.discogs.com/sell/item/1093067101"},"… 48 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.