# 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.

- Page: https://fous.com/methods/discogs.com/get-release
- Method: `discogs.com/get_release`, version 1
- Website: discogs.com
- Returns: title, artists, label, catalog number, format, country, release date, genres, styles, tracks, community counts, prices
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `title` | string | yes | `"Rumours"` | Album or single title, or a Discogs release link or ID. Example: Rumours |
| `artist` | string | no | `"Fleetwood Mac"` | Artist to distinguish records with the same title. Example: Fleetwood Mac Default "". |
| `format` | string | no |  | Preferred physical format. Example: vinyl One of "any", "vinyl", "cd", "cassette". Default "any". |
| `country` | string | no |  | Country of the specific pressing. Example: UK Default "". |
| `pressing_year` | integer | no |  | Year of the specific pressing. Example: 1977 Default 0. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "title": "Rumours",
  "artist": "Fleetwood Mac"
}
```

Its output:

```json
{
  "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"
  }
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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

## Input schema

```json
{
  "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

```json
{
  "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
}
```

## See more

- [Discogs API: Get artist discography](https://fous.com/methods/discogs.com/get-artist-discography.md): Lists an artist's albums, singles, EPs and compilations on Discogs, grouped by master release and ordered oldest first.
- [Apple API: Get album](https://fous.com/methods/music.apple.com/get-album.md): Finds an Apple Music album by title and optional artist, or by album link, and returns its matched release, purchase details and tracks in order.
- [Bandcamp API: Get album](https://fous.com/methods/bandcamp.com/get-album.md): Gets 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.
- [Deezer API: Get album](https://fous.com/methods/deezer.com/get-album.md): Looks up a Deezer album by name, album link, or ID, optionally matching an artist, and returns its details and ordered tracklist.
- [MusicBrainz API: Get song identifiers](https://fous.com/methods/musicbrainz.org/get-song-identifiers.md): Finds 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.
- [Spotify API: Get album](https://fous.com/methods/open.spotify.com/get-album.md): Gets a Spotify album by name (optionally with the artist), album link or album ID, with its details and ordered track list including play counts.
- [Pitchfork API: Get album review](https://fous.com/methods/pitchfork.com/get-album-review.md): Finds Pitchfork's newest review that matches an album title and artist, and returns the review's rating and details.
- [Goodreads API: Get book](https://fous.com/methods/goodreads.com/get-book.md): Gets 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.
- [All Discogs methods](https://fous.com/methods/discogs.com.md)