Discogs API: Get release
Finds a Discogs release by title, artist or release link and returns its edition details, tracks, community counts, current price and sold price statistics.
Unofficial. Not affiliated with or endorsed by Discogs.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Title, required
title Album or single title, or a Discogs release link or ID. Example: Rumours
Rumours
- Artist optional
artist Artist to distinguish records with the same title. Example: Fleetwood Mac
Fleetwood Mac
Default
.- Format optional
format Preferred physical format. Example: vinyl
any (default)
One of
any,vinyl,cd,cassette.- Country optional
country Country of the specific pressing. Example: UK
(default)
- Pressing Year optional
pressing_year Year of the specific pressing. Example: 1977
0 (default)
Whole number.
Input as JSON
{ "title": "Rumours", "artist": "Fleetwood Mac"}Output
{ "label": "Warner Bros. Records", "title": "Rumours", "format": "Vinyl (LP, Album)", "genres": [ "Rock" ], "styles": [ "Pop Rock", "Soft Rock", "AOR" ], "tracks": [ { "title": "Second Hand News", "length": "2:43", "position": "A1" }, { "title": "Dreams", "length": "4:14", "position": "A2" }, { "title": "Never Going Back Again", "length": "2:02", "position": "A3" } ], "artists": [ "Fleetwood Mac" ], "country": "US", "master_id": 38722, "release_id": 526351, "discogs_link": "https://www.discogs.com/release/526351-Fleetwood-Mac-Rumours" , "rating_count": 5087, "release_date": "1977", "catalog_number": "BSK 3010", "collectors_have": 67657, "collectors_want": 18584, "copies_for_sale": 87, "community_rating": 4.55, "lowest_sold_price": null, "median_sold_price": null, "highest_sold_price": null, "lowest_current_price": { "amount": 9.33, "currency": "USD" }}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"discogs.com/get_release","input":{"title":"Rumours","artist":"Fleetwood Mac"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "discogs.com/get_release" , "input": { "title": "Rumours", "artist": "Fleetwood Mac" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "discogs.com/get_release" , "input": { "title": "Rumours", "artist": "Fleetwood Mac" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run discogs.com/get_release# with {"title":"Rumours","artist":"Fleetwood Mac"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "title" ], "properties": { "title": { "type": "string", "description": "Album or single title, or a Discogs release link or ID. Example: Rumours" }, "artist": { "type": "string", "default": "", "description": "Artist to distinguish records with the same title. Example: Fleetwood Mac" }, "format": { "enum": [ "any", "vinyl", "cd", "cassette" ], "type": "string", "default": "any", "description": "Preferred physical format. Example: vinyl" }, "country": { "type": "string", "default": "", "description": "Country of the specific pressing. Example: UK" }, "pressing_year": { "type": "integer", "default": 0, "description": "Year of the specific pressing. Example: 1977" } }}Output schema
{ "type": "object", "required": [ "title", "artists", "label", "catalog_number", "format", "country", "release_date", "genres", "styles", "tracks", "collectors_have", "collectors_want", "community_rating", "rating_count", "copies_for_sale", "lowest_current_price", "lowest_sold_price", "median_sold_price", "highest_sold_price", "discogs_link", "release_id", "master_id" ], "properties": { "label": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "format": { "type": [ "string", "null" ] }, "genres": { "type": "array", "items": { "type": "string" } }, "styles": { "type": "array", "items": { "type": "string" } }, "tracks": { "type": "array", "items": { "type": "object", "required": [ "position", "title", "length" ], "properties": { "title": { "type": "string" }, "length": { "type": [ "string", "null" ] }, "position": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "artists": { "type": "array", "items": { "type": "string" } }, "country": { "type": [ "string", "null" ] }, "master_id": { "type": [ "integer", "null" ], "x-fous-developer": true }, "release_id": { "type": "integer", "x-fous-developer": true }, "discogs_link": { "type": "string" }, "rating_count": { "type": [ "integer", "null" ] }, "release_date": { "type": [ "string", "null" ] }, "catalog_number": { "type": [ "string", "null" ] }, "collectors_have": { "type": [ "integer", "null" ] }, "collectors_want": { "type": [ "integer", "null" ] }, "copies_for_sale": { "type": [ "integer", "null" ] }, "community_rating": { "type": [ "number", "null" ], "description": "Average rating out of 5." }, "lowest_sold_price": { "anyOf": [ { "type": "object", "required": [ "amount", "currency" ], "properties": { "amount": { "type": "number" }, "currency": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "median_sold_price": { "anyOf": [ { "type": "object", "required": [ "amount", "currency" ], "properties": { "amount": { "type": "number" }, "currency": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "highest_sold_price": { "anyOf": [ { "type": "object", "required": [ "amount", "currency" ], "properties": { "amount": { "type": "number" }, "currency": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] }, "lowest_current_price": { "anyOf": [ { "type": "object", "required": [ "amount", "currency" ], "properties": { "amount": { "type": "number" }, "currency": { "type": "string" } }, "additionalProperties": false }, { "type": "null" } ] } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
discogs.com/get_release- Returns
- title, artists, label, catalog number, format, country, release date, genres, styles, tracks, community counts, prices
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method discogs.com/get_release with the inputs above.
Ask your agent
- Find the Discogs release for Rumours by Fleetwood Mac, UK vinyl pressing from 1977, with tracklist and current price
- What's the label and catalog number for the 1977 UK vinyl pressing of Rumours?
- Show me community have and want counts plus sold price stats for Kind of Blue on CD
- Look up the Discogs listing for Abbey Road, the 1969 cassette release, and give its genres and styles
- Get the release date, country and format details for the Bowie Heroes single pressing
See more
All Discogs methodsLists an artist's albums, singles, EPs and compilations on Discogs, grouped by master release and ordered oldest first.
discogs.com/get_artist_discographyFinds an Apple Music album by title and optional artist, or by album link, and returns its matched release, purchase details and tracks in order.
music.apple.com/get_albumGets a Bandcamp album by title and optional artist, or by album link, with prices, physical formats, tracks and album details. Supporter count covers only profiles shown on the page; copies left is given only when displayed.
bandcamp.com/get_albumLooks up a Deezer album by name, album link, or ID, optionally matching an artist, and returns its details and ordered tracklist.
deezer.com/get_albumFinds the best-matching studio recording on MusicBrainz for a song title and artist. Returns its ISRCs, first release date and up to 25 of its earliest releases.
musicbrainz.org/get_song_identifiersGets a Spotify album by name (optionally with the artist), album link or album ID, with its details and ordered track list including play counts.
open.spotify.com/get_albumFinds Pitchfork's newest review that matches an album title and artist, and returns the review's rating and details.
pitchfork.com/get_album_reviewGets one Goodreads book's details, reader ratings and edition information. The book can be a title, an ISBN or a book link; a title uses the best search match.
goodreads.com/get_book