# Discogs

> Search the Discogs music database and read what it holds: releases with full track listings and credits, albums across every pressing, artists, labels and their catalogues. Read a member's collection, wantlist, lists and profile, and check what a record is selling for on the Discogs Marketplace.

App · Music & Podcasts · 20 actions. Web page: https://docs.lodol.com/docs/integrations/discogs

## Actions

### Get artist

Get an artist's profile: their biography, real name, the names they also record under, their aliases, the groups they belong to (or the line-up, for a band), and their own web links.

**Inputs**

- Artist ID (`artist_id`, number, required): The Discogs artist ID - the number in an artist's web address, as in discogs.com/artist/125246. At least 1.

**Outputs**

- `aliases` (list): Other names the same person records under
- `data_quality` (text): How complete Discogs considers the entry
- `groups` (list): For a person, the groups they play in
- `id` (number): The artist's Discogs ID
- `image_count` (number): How many images there are
- `image_url` (text): Link to the main image
- `members` (list): For a group, who is (or was) in it
- `name` (text): The artist's name
- `name_variations` (list): Other spellings the name appears under
- `profile` (text): A short biography written by members
- `real_name` (text): Their real name, for a performing alias
- `thumbnail_url` (text): Link to a 150px thumbnail
- `url` (text): Link to the artist on Discogs
- `urls` (list): The artist's own sites and profiles

**Example output**

```json
{
  "aliases": [],
  "data_quality": "Needs Vote",
  "groups": [],
  "id": 125246,
  "image_count": 12,
  "image_url": "https://i.discogs.com/image.jpeg",
  "members": [
    {
      "active": false,
      "id": 305344,
      "name": "Kurt Cobain"
    },
    {
      "active": false,
      "id": 316766,
      "name": "Dave Grohl"
    }
  ],
  "name": "Nirvana",
  "name_variations": [
    "Nirvana (2)"
  ],
  "profile": "American rock band formed in Aberdeen, Washington in 1987.",
  "real_name": null,
  "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
  "url": "https://www.discogs.com/artist/125246-Nirvana",
  "urls": [
    "https://www.nirvana.com"
  ]
}
```

### Get collection value

Get what a collection is worth, as the minimum, median and maximum Discogs estimates from its marketplace history. Only the collection's owner may read this, so leave the username blank.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.

**Outputs**

- `maximum` (text): The high estimate, formatted
- `maximum_value` (number): The high estimate as a number
- `median` (text): The middle estimate, formatted
- `median_value` (number): The middle estimate as a number
- `minimum` (text): The low estimate, formatted in the owner's currency
- `minimum_value` (number): The low estimate as a number, for arithmetic
- `username` (text): Whose collection was valued

**Example output**

```json
{
  "maximum": "$17,332.10",
  "maximum_value": 17332.1,
  "median": "$9,140.20",
  "median_value": 9140.2,
  "minimum": "$4,821.75",
  "minimum_value": 4821.75,
  "username": "teo"
}
```

### Get label

Get a record label's profile: its history, contact details, the imprints it runs, the group it belongs to, and its own web links.

**Inputs**

- Label ID (`label_id`, number, required): The Discogs label ID - the number in a label's web address, as in discogs.com/label/29377. At least 1.

**Outputs**

- `contact_info` (text): The label's address and contact details
- `data_quality` (text): How complete Discogs considers the entry
- `id` (number): The label's Discogs ID
- `image_count` (number): How many images there are
- `image_url` (text): Link to the main image
- `name` (text): The label's name
- `parent_label` (object): The label group this one belongs to, if any
- `profile` (text): A short history written by members
- `sublabels` (list): The imprints this label runs
- `thumbnail_url` (text): Link to a 150px thumbnail
- `url` (text): Link to the label on Discogs
- `urls` (list): The label's own sites and profiles

**Example output**

```json
{
  "contact_info": "!K7 Records, Gerichtstr. 35, 13347 Berlin, Germany",
  "data_quality": "Needs Vote",
  "id": 29377,
  "image_count": 1,
  "image_url": "https://i.discogs.com/image.jpeg",
  "name": "!K7 Records",
  "parent_label": {
    "id": 666606,
    "name": "!K7 Label Group"
  },
  "profile": "Berlin label founded in 1996, home of the DJ-Kicks series.",
  "sublabels": [
    {
      "id": 1100080,
      "name": "!K7 Flavour"
    }
  ],
  "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
  "url": "https://www.discogs.com/label/29377-K7-Records",
  "urls": [
    "https://www.k7.com"
  ]
}
```

### Get list

Get one Discogs list and everything on it, with the note its curator wrote against each entry. A list can hold releases, albums, artists and labels together.

**Inputs**

- List ID (`list_id`, number, required): The Discogs list ID - the number at the end of a list's web address. List user lists returns one for each list. At least 1.

**Outputs**

- `date_added` (text): When it was created
- `date_changed` (text): When it last changed
- `description` (text): What the list is for
- `id` (number): The list's Discogs ID
- `image_url` (text): Link to the list's own image
- `item_count` (number): How many entries are on the list
- `items` (list): What is on the list, in the curator's order
- `name` (text): The list's name
- `owner` (text): The username of whoever curates it
- `public` (true/false): Whether anyone can see it
- `url` (text): Link to the list on Discogs

**Example output**

```json
{
  "date_added": "2009-02-11T10:50:32-08:00",
  "date_changed": "2012-03-28T23:35:28-07:00",
  "description": "The first records added to the database.",
  "id": 1,
  "image_url": null,
  "item_count": 1,
  "items": [
    {
      "comment": "this is the first thing I added to Discogs",
      "display_title": "The Persuader - Stockholm",
      "have": 3172,
      "id": 1,
      "image_url": null,
      "type": "release",
      "url": "https://www.discogs.com/release/1-The-Persuader-Stockholm",
      "want": 2851
    }
  ],
  "name": "Building Discogs",
  "owner": "teo",
  "public": true,
  "url": "https://www.discogs.com/lists/Building-Discogs/1"
}
```

### Get marketplace stats

Get what one release is selling for on the Discogs Marketplace right now: how many copies are listed and the cheapest asking price. Answers with no copies rather than an error when nobody is selling it.

**Inputs**

- Release ID (`release_id`, number, required): The Discogs release ID - the number in a release's web address, as in discogs.com/release/249504. Search releases returns one for every hit. At least 1.
- Price currency (`currency`, text): Which currency to report marketplace prices in. Leave blank to use the connected account's own buyer currency. One of: `USD` (US dollar (USD)), `GBP` (Pound sterling (GBP)), `EUR` (Euro (EUR)), `CAD` (Canadian dollar (CAD)), `AUD` (Australian dollar (AUD)), `JPY` (Japanese yen (JPY)), `CHF` (Swiss franc (CHF)), `MXN` (Mexican peso (MXN)), `BRL` (Brazilian real (BRL)), `NZD` (New Zealand dollar (NZD)), `SEK` (Swedish krona (SEK)), `ZAR` (South African rand (ZAR)).

**Outputs**

- `blocked_from_sale` (true/false): Whether Discogs blocks this release from being sold
- `currency` (text): The currency the price is quoted in
- `lowest_price` (number): The cheapest asking price, or null if none
- `num_for_sale` (number): How many copies are listed for sale
- `release_id` (number): The release these prices are for
- `url` (text): Link to the release's marketplace listings

**Example output**

```json
{
  "blocked_from_sale": false,
  "currency": "USD",
  "lowest_price": 0.68,
  "num_for_sale": 123,
  "release_id": 249504,
  "url": "https://www.discogs.com/sell/release/249504"
}
```

### Get master release

Get an album as a work rather than as one pressing of it: its canonical title, year, track listing and artwork, plus the pressing Discogs treats as definitive and the cheapest copy for sale across every pressing.

**Inputs**

- Master release ID (`master_id`, number, required): The Discogs master release ID - the number in an album's web address, as in discogs.com/master/13814. A release's 'master_id' points at it. At least 1.

**Outputs**

- `artist` (text): The credited artist, as one line
- `artists` (list): The credited artists, in the order they are printed
- `data_quality` (text): How complete Discogs considers the entry
- `genres` (list): Its genres
- `id` (number): The master release's ID
- `image_count` (number): How many images there are
- `image_url` (text): Link to the main image
- `lowest_price` (number): The cheapest copy of any pressing
- `main_release_id` (number): The pressing Discogs treats as definitive - pass this to Get release
- `most_recent_release_id` (number): The most recently issued pressing
- `num_for_sale` (number): How many copies are listed across all pressings
- `styles` (list): Its styles
- `thumbnail_url` (text): Link to a 150px thumbnail
- `title` (text): The album title
- `tracklist` (list): The track listing, in order
- `url` (text): Link to the album on Discogs
- `videos` (list): Videos members have linked to this album
- `year` (number): The year the album first came out

**Example output**

```json
{
  "artist": "Nirvana",
  "artists": [
    {
      "id": 125246,
      "name": "Nirvana"
    }
  ],
  "data_quality": "Correct",
  "genres": [
    "Rock"
  ],
  "id": 13814,
  "image_count": 6,
  "image_url": "https://i.discogs.com/image.jpeg",
  "lowest_price": 4.99,
  "main_release_id": 367760,
  "most_recent_release_id": 30246109,
  "num_for_sale": 1042,
  "styles": [
    "Grunge",
    "Alternative Rock"
  ],
  "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
  "title": "Nevermind",
  "tracklist": [
    {
      "duration": "5:02",
      "position": "A1",
      "title": "Smells Like Teen Spirit",
      "type": "track"
    }
  ],
  "url": "https://www.discogs.com/master/13814-Nirvana-Nevermind",
  "videos": [],
  "year": 1991
}
```

### Get my identity

Get the Discogs account this connection is signed in as. Use it to confirm a connection works, or to feed the username into a later step.

**Inputs**: None.

**Outputs**

- `id` (number): The account's Discogs ID
- `url` (text): Link to the account's Discogs profile
- `username` (text): The account's username

**Example output**

```json
{
  "id": 1,
  "url": "https://www.discogs.com/user/teo",
  "username": "teo"
}
```

### Get release

Get one pressing of a record in full: its track listing with durations, the artists and everyone credited on it, the labels and catalogue numbers, barcodes and matrix codes, sleeve images, and how many copies are for sale and at what price.

**Inputs**

- Release ID (`release_id`, number, required): The Discogs release ID - the number in a release's web address, as in discogs.com/release/249504. Search releases returns one for every hit. At least 1.
- Price currency (`currency`, text): Which currency to report marketplace prices in. Leave blank to use the connected account's own buyer currency. One of: `USD` (US dollar (USD)), `GBP` (Pound sterling (GBP)), `EUR` (Euro (EUR)), `CAD` (Canadian dollar (CAD)), `AUD` (Australian dollar (AUD)), `JPY` (Japanese yen (JPY)), `CHF` (Swiss franc (CHF)), `MXN` (Mexican peso (MXN)), `BRL` (Brazilian real (BRL)), `NZD` (New Zealand dollar (NZD)), `SEK` (Swedish krona (SEK)), `ZAR` (South African rand (ZAR)).

**Outputs**

- `artist` (text): The credited artist, as one line
- `artists` (list): The credited artists, in the order they are printed
- `community` (object): What Discogs' members report about it
- `companies` (list): The companies behind it - pressing plants, distributors, copyright holders
- `country` (text): Where this pressing was issued
- `credits` (list): Everyone else credited - producers, engineers, players, designers - with their roles
- `data_quality` (text): How complete Discogs considers the entry
- `format` (text): The formats as one line
- `formats` (list): The physical or digital formats it was issued on
- `genres` (list): Its genres
- `id` (number): The release's Discogs ID
- `identifiers` (list): Codes printed on the record - barcodes, matrix and runout etchings, label codes, rights society marks
- `image_count` (number): How many images there are
- `image_url` (text): Link to the main image
- `labels` (list): The labels that issued it, each with its catalogue number
- `lowest_price` (number): The cheapest copy currently listed
- `master_id` (number): The album this is a pressing of
- `notes` (text): Members' notes about this pressing
- `num_for_sale` (number): How many copies are listed for sale now
- `released` (text): The release date as Discogs holds it, which may be partial, as in '1987-07-00'
- `released_formatted` (text): The same date written out, as in 'Jul 1987'
- `status` (text): Whether the entry is accepted or still in draft
- `styles` (list): Its styles
- `thumbnail_url` (text): Link to a 150px thumbnail
- `title` (text): The release title
- `tracklist` (list): The track listing, in order
- `url` (text): Link to the release on Discogs
- `videos` (list): Videos members have linked to this release
- `year` (number): The year it was issued

**Example output**

```json
{
  "artist": "Rick Astley",
  "artists": [
    {
      "id": 72872,
      "name": "Rick Astley"
    }
  ],
  "community": {
    "have": 4104,
    "rating_average": 3.86,
    "rating_count": 240,
    "want": 585
  },
  "companies": [
    {
      "catalog_number": null,
      "id": 82835,
      "name": "BMG Records (UK) Ltd."
    }
  ],
  "country": "UK",
  "credits": [
    {
      "id": 78275,
      "name": "Mark McGuire",
      "role": "Engineer"
    }
  ],
  "data_quality": "Correct",
  "format": "Vinyl, 7\", 45 RPM, Single",
  "formats": [
    {
      "descriptions": [
        "7\"",
        "45 RPM",
        "Single"
      ],
      "name": "Vinyl"
    }
  ],
  "genres": [
    "Electronic",
    "Pop"
  ],
  "id": 249504,
  "identifiers": [
    {
      "description": null,
      "type": "Barcode",
      "value": "5012394144777"
    }
  ],
  "image_count": 4,
  "image_url": "https://i.discogs.com/image.jpeg",
  "labels": [
    {
      "catalog_number": "PB 41447",
      "id": 895,
      "name": "RCA"
    }
  ],
  "lowest_price": 0.94,
  "master_id": 96559,
  "notes": "UK release has a black label.",
  "num_for_sale": 123,
  "released": "1987-07-00",
  "released_formatted": "Jul 1987",
  "status": "Accepted",
  "styles": [
    "Euro-Disco"
  ],
  "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
  "title": "Never Gonna Give You Up",
  "tracklist": [
    {
      "duration": "3:32",
      "position": "A",
      "title": "Never Gonna Give You Up",
      "type": "track"
    }
  ],
  "url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
  "videos": [
    {
      "duration_seconds": 214,
      "title": "Rick Astley - Never Gonna Give You Up",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  ],
  "year": 1987
}
```

### Get release rating

Get how Discogs' members have rated one release: the average out of five and how many people voted.

**Inputs**

- Release ID (`release_id`, number, required): The Discogs release ID - the number in a release's web address, as in discogs.com/release/249504. Search releases returns one for every hit. At least 1.

**Outputs**

- `average` (number): The average rating, out of five
- `count` (number): How many members have rated it
- `release_id` (number): The release that was rated
- `url` (text): Link to the release on Discogs

**Example output**

```json
{
  "average": 3.86,
  "count": 240,
  "release_id": 249504,
  "url": "https://www.discogs.com/release/249504"
}
```

### Get user profile

Get a Discogs member's public profile: where they are, when they joined, how big their collection and wantlist are, how much they have contributed to the database, and their buyer and seller ratings.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.

**Outputs**

- `avatar_url` (text): Link to their avatar
- `buyer_num_ratings` (number): How many sellers have rated them
- `buyer_rating` (number): Their buyer rating, as a percentage
- `home_page` (text): Their own website, when set
- `id` (number): The member's Discogs ID
- `location` (text): Where they are
- `name` (text): Their display name, when set
- `num_collection` (number): How many records are in their collection
- `num_for_sale` (number): How many records they have for sale
- `num_lists` (number): How many lists they keep
- `num_wantlist` (number): How many are on their wantlist
- `profile` (text): The bio on their profile
- `rating_avg` (number): The average rating they give
- `registered` (text): When they joined Discogs
- `releases_contributed` (number): How many database entries they contributed to
- `releases_rated` (number): How many releases they have rated
- `seller_num_ratings` (number): How many buyers have rated them
- `seller_rating` (number): Their seller rating, as a percentage
- `url` (text): Link to their Discogs profile
- `username` (text): Their username

**Example output**

```json
{
  "avatar_url": "https://i.discogs.com/avatar.jpeg",
  "buyer_num_ratings": 29,
  "buyer_rating": 100.0,
  "home_page": null,
  "id": 1,
  "location": "Portland, Oregon, USA",
  "name": "Kevin Lewandowski",
  "num_collection": 1606,
  "num_for_sale": 0,
  "num_lists": 2,
  "num_wantlist": 460,
  "profile": "Discogs founder.",
  "rating_avg": 4.44,
  "registered": "2000-10-12T15:17:00-07:00",
  "releases_contributed": 433,
  "releases_rated": 110,
  "seller_num_ratings": 0,
  "seller_rating": 0.0,
  "url": "https://www.discogs.com/user/teo",
  "username": "teo"
}
```

### List artist releases

List an artist's discography. Each row says whether it is an album or one pressing, and what the artist did on it - their own record, an appearance on someone else's, a remix or a production credit.

**Inputs**

- Artist ID (`artist_id`, number, required): The Discogs artist ID - the number in an artist's web address, as in discogs.com/artist/125246. At least 1.
- Sort by (`sort`, text): Which field to sort the discography by. Leave blank for Discogs' own order. One of: `year`, `title`, `format`.
- Sort direction (`sort_order`, text): Which way round to sort. Defaults to ascending. One of: `asc` (Ascending (A-Z, oldest first)), `desc` (Descending (Z-A, newest first)). Default: `asc`.
- Maximum results (`limit`, number): How many releases to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `artist_id` (number): The artist whose discography this is
- `releases` (list): The discography
- `returned` (number): How many rows this step returned
- `total_releases` (number): How many rows the discography has in total

**Example output**

```json
{
  "artist_id": 125246,
  "releases": [
    {
      "artist": "Nirvana",
      "format": null,
      "have": 24310,
      "id": 13814,
      "label": "DGC",
      "role": "Main",
      "status": "Accepted",
      "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
      "title": "Nevermind",
      "type": "master",
      "url": "https://www.discogs.com/master/13814",
      "want": 8123,
      "year": 1991
    }
  ],
  "returned": 1,
  "total_releases": 1372
}
```

### List collection folders

List the folders a member's collection is filed into, with how many records are in each. Only the 'All' folder is visible in someone else's collection.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.

**Outputs**

- `folders` (list): The folders, 'All' first
- `username` (text): Whose collection this is

**Example output**

```json
{
  "folders": [
    {
      "count": 1606,
      "id": 0,
      "name": "All"
    },
    {
      "count": 20,
      "id": 1,
      "name": "Uncategorized"
    }
  ],
  "username": "teo"
}
```

### List collection items

List the records in one folder of a member's collection, each with when it was added, the owner's rating, and their notes (such as media and sleeve condition) under the field names they gave them.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
- Folder (`folder_id`, number): Pick a folder, or enter its numeric ID. Defaults to 'All' (0). Only 'All' is readable in someone else's collection, so the other folders offered here are the connected account's own. At least 0. Default: `0`.
- Sort by (`sort`, text): Which field to sort the records by. Leave blank for Discogs' own order. One of: `label`, `artist`, `title`, `catno` (Catalogue number), `format`, `rating` (Your rating), `year`, `added` (When it was added).
- Sort direction (`sort_order`, text): Which way round to sort. Defaults to ascending. One of: `asc` (Ascending (A-Z, oldest first)), `desc` (Descending (Z-A, newest first)). Default: `asc`.
- Maximum results (`limit`, number): How many records to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `folder_id` (number): Which folder was read
- `items` (list): The records in the folder
- `returned` (number): How many records this step returned
- `total_items` (number): How many are in the folder in total
- `username` (text): Whose collection this is

**Example output**

```json
{
  "folder_id": 0,
  "items": [
    {
      "artist": "+N",
      "artists": [
        {
          "id": 32554,
          "name": "+N"
        }
      ],
      "cover_image_url": "https://i.discogs.com/cover.jpeg",
      "date_added": "2009-08-20T07:00:00-07:00",
      "folder_id": 1,
      "format": "CD, Album, Limited Edition",
      "formats": [
        {
          "descriptions": [
            "Album",
            "Limited Edition"
          ],
          "name": "CD"
        }
      ],
      "genres": [
        "Electronic"
      ],
      "instance_id": 760,
      "labels": [
        {
          "catalog_number": "PS 08/46",
          "id": 60,
          "name": "Fax +49-69/450464"
        }
      ],
      "master_id": 2302831,
      "notes": {
        "Media Condition": "Near Mint (NM or M-)"
      },
      "rating": 5,
      "release_id": 46377,
      "styles": [
        "Ambient"
      ],
      "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
      "title": "Plane",
      "url": "https://www.discogs.com/release/46377",
      "year": 1994
    }
  ],
  "returned": 1,
  "total_items": 1606,
  "username": "teo"
}
```

### List label releases

List a label's catalogue, in catalogue-number order, with the artist, title, year and format of each record it issued.

**Inputs**

- Label ID (`label_id`, number, required): The Discogs label ID - the number in a label's web address, as in discogs.com/label/29377. At least 1.
- Maximum results (`limit`, number): How many releases to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `label_id` (number): The label whose catalogue this is
- `releases` (list): The catalogue
- `returned` (number): How many releases this step returned
- `total_releases` (number): How many the label has issued in total

**Example output**

```json
{
  "label_id": 29377,
  "releases": [
    {
      "artist": "Kid Loco",
      "catalog_number": "!K7081CD",
      "format": "CD, Mixed, RE",
      "id": 1016,
      "status": "Accepted",
      "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
      "title": "DJ-Kicks:",
      "url": "https://www.discogs.com/release/1016",
      "year": 1999
    }
  ],
  "returned": 1,
  "total_releases": 3401
}
```

### List master release versions

List every pressing of one album - each issue, reissue and repress, with its country, year, format, label and catalogue number. Filter to one format, label, country or year to find the pressing you are after.

**Inputs**

- Master release ID (`master_id`, number, required): The Discogs master release ID - the number in an album's web address, as in discogs.com/master/13814. A release's 'master_id' points at it. At least 1.
- Format (`release_format`, text): Only list pressings on this format, such as 'Vinyl' or 'CD'.
- Label (`label`, text): Only list pressings issued by this label.
- Year released (`released`, text): Only list pressings issued in this year.
- Country (`country`, text): Only list pressings issued in this country.
- Sort by (`sort`, text): Which field to sort the pressings by. Leave blank for Discogs' own order. One of: `released` (Year released), `title`, `format`, `label`, `catno` (Catalogue number), `country`.
- Sort direction (`sort_order`, text): Which way round to sort. Defaults to ascending. One of: `asc` (Ascending (A-Z, oldest first)), `desc` (Descending (Z-A, newest first)). Default: `asc`.
- Maximum results (`limit`, number): How many pressings to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `master_id` (number): The album these pressings belong to
- `returned` (number): How many pressings this step returned
- `total_versions` (number): How many pressings there are in total
- `versions` (list): The pressings

**Example output**

```json
{
  "master_id": 13814,
  "returned": 1,
  "total_versions": 1183,
  "versions": [
    {
      "catalog_number": "DGC-24425",
      "country": "US",
      "format": "Album",
      "have": 4310,
      "id": 367760,
      "label": "DGC",
      "major_formats": [
        "Vinyl"
      ],
      "released": "1991",
      "status": "Accepted",
      "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
      "title": "Nevermind",
      "url": "https://www.discogs.com/release/367760",
      "want": 6221
    }
  ]
}
```

### List user contributions

List the releases a member has contributed edits to, whether or not they first submitted them.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
- Sort by (`sort`, text): Which field to sort the contributions by. Leave blank for Discogs' own order. One of: `label`, `artist`, `title`, `catno` (Catalogue number), `format`, `rating` (Your rating), `year`, `added` (When it was added).
- Sort direction (`sort_order`, text): Which way round to sort. Defaults to ascending. One of: `asc` (Ascending (A-Z, oldest first)), `desc` (Descending (Z-A, newest first)). Default: `asc`.
- Maximum results (`limit`, number): How many contributions to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `contributions` (list): The releases they have edited
- `returned` (number): How many contributions this step returned
- `total_contributions` (number): How many they have made in total
- `username` (text): Whose contributions these are

**Example output**

```json
{
  "contributions": [
    {
      "artist": "Just Plain English Band",
      "community": {
        "have": 38,
        "rating_average": 4.67,
        "rating_count": 6,
        "want": 40
      },
      "country": "US",
      "data_quality": "Correct",
      "format": "Vinyl, 7\", 45 RPM",
      "id": 34169623,
      "labels": [
        {
          "catalog_number": "GFR 001",
          "id": 4142179,
          "name": "Grand Function Records"
        }
      ],
      "status": "Accepted",
      "title": "Plain English Groove",
      "url": "https://www.discogs.com/release/34169623",
      "year": 2025
    }
  ],
  "returned": 1,
  "total_contributions": 433,
  "username": "teo"
}
```

### List user lists

List a member's Discogs lists - the groupings they curate, such as a wants shortlist or a best-of. Private lists appear only when reading the connected account's own.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
- Maximum results (`limit`, number): How many lists to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `lists` (list): Their lists
- `returned` (number): How many lists this step returned
- `total_lists` (number): How many they keep in total
- `username` (text): Whose lists these are

**Example output**

```json
{
  "lists": [
    {
      "date_added": "2009-02-11T10:50:32-08:00",
      "date_changed": "2012-03-28T23:35:28-07:00",
      "description": "The first records added to the database.",
      "id": 1,
      "name": "Building Discogs",
      "public": true,
      "url": "https://www.discogs.com/lists/Building-Discogs/1"
    }
  ],
  "returned": 1,
  "total_lists": 2,
  "username": "teo"
}
```

### List user submissions

List the artists, labels and releases a member has added to the Discogs database, newest first.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
- Maximum results (`limit`, number): How many submissions to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `returned` (number): How many submissions this step returned
- `submissions` (list): What they added to the database
- `total_submissions` (number): How many they have made in total
- `username` (text): Whose submissions these are

**Example output**

```json
{
  "returned": 1,
  "submissions": [
    {
      "artist": "War From A Harlots Mouth",
      "country": "Germany",
      "data_quality": "Correct",
      "format": "Vinyl, LP, Album",
      "id": 3967745,
      "labels": [
        {
          "catalog_number": "SOM266LP",
          "id": 33674,
          "name": "Season Of Mist"
        }
      ],
      "status": "Accepted",
      "title": "Voyeur",
      "type": "release",
      "url": "https://www.discogs.com/release/3967745",
      "year": 2012
    }
  ],
  "total_submissions": 228,
  "username": "nik"
}
```

### List wantlist

List the records on a member's wantlist, each with when it was added and the rating they gave it. Pass a release ID from here to Get marketplace stats to see what a want is going for.

**Inputs**

- Discogs username (`username`, text): Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
- Sort by (`sort`, text): Which field to sort the wantlist by. Leave blank for Discogs' own order. One of: `label`, `artist`, `title`, `catno` (Catalogue number), `format`, `rating` (Your rating), `year`, `added` (When it was added).
- Sort direction (`sort_order`, text): Which way round to sort. Defaults to ascending. One of: `asc` (Ascending (A-Z, oldest first)), `desc` (Descending (Z-A, newest first)). Default: `asc`.
- Maximum results (`limit`, number): How many records to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `returned` (number): How many records this step returned
- `total_wants` (number): How many are on the wantlist in total
- `username` (text): Whose wantlist this is
- `wants` (list): The records they want

**Example output**

```json
{
  "returned": 1,
  "total_wants": 460,
  "username": "teo",
  "wants": [
    {
      "artist": "Moodymann",
      "artists": [
        {
          "id": 1094,
          "name": "Moodymann"
        }
      ],
      "cover_image_url": "https://i.discogs.com/cover.jpeg",
      "date_added": "2016-02-23T10:37:55-08:00",
      "format": "CD, Mixed",
      "formats": [
        {
          "descriptions": [
            "Mixed"
          ],
          "name": "CD"
        }
      ],
      "genres": [
        "Electronic",
        "Hip Hop"
      ],
      "labels": [
        {
          "catalog_number": "K7327CD",
          "id": 29377,
          "name": "!K7 Records"
        }
      ],
      "master_id": 961089,
      "notes": null,
      "rating": 0,
      "release_id": 8142256,
      "styles": [
        "Deep House"
      ],
      "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
      "title": "DJ-Kicks",
      "url": "https://www.discogs.com/release/8142256",
      "year": 2016
    }
  ]
}
```

### Search the database

Search Discogs' music database for releases, albums, artists or labels. Combine free text with filters such as artist, label, year, format, country, genre, catalogue number or barcode - a barcode alone identifies an exact pressing.

**Inputs**

- Search text (`query`, text): What to search for. Matches across titles, artists and labels. Leave blank to search by the filters alone.
- Search for (`search_type`, text): Which kind of thing to return. Leave blank to return all four kinds mixed together. One of: `release` (Release - one pressing, with its own catalogue number), `master` (Master release - an album, across all its pressings), `artist`, `label`.
- Artist name (`artist`, text): Only match records credited to this artist.
- Release title (`release_title`, text): Only match records with this title.
- Label name (`label`, text): Only match records issued by this label.
- Genre (`genre`, text): Only match this genre - Discogs' broad category, such as 'Rock', 'Electronic' or 'Jazz'.
- Style (`style`, text): Only match this style - the narrower classification under a genre, such as 'Grunge' or 'Deep House'.
- Country (`country`, text): Only match records issued in this country.
- Year (`year`, text): Only match records issued in this year.
- Format (`format`, text): Only match this format, such as 'Vinyl', 'CD', 'Cassette' or 'Album'.
- Catalogue number (`catalog_number`, text): Only match this catalogue number - the label's own reference, printed on the spine or label.
- Barcode (`barcode`, text): Only match this barcode. A barcode usually identifies one exact pressing, so this is the way to look up a record you are holding.
- Track title (`track`, text): Only match records containing a track with this title.
- Credit (`credit`, text): Only match records crediting this person anywhere - a producer, engineer or session player, not just the billed artist.
- Maximum results (`limit`, number): How many results to return at most. Pages are fetched behind the scenes until this many are collected. Defaults to 25. From 1 to 250. Default: `25`.

**Outputs**

- `results` (list): The matches, most relevant first
- `returned` (number): How many results this step returned
- `total_results` (number): How many matches Discogs found in total

**Example output**

```json
{
  "results": [
    {
      "barcodes": [
        "720642442517"
      ],
      "catalog_number": "DGC-24425",
      "country": "US",
      "cover_image_url": "https://i.discogs.com/cover.jpeg",
      "formats": [
        "Vinyl",
        "LP",
        "Album"
      ],
      "genres": [
        "Rock"
      ],
      "have": 24310,
      "id": 367760,
      "labels": [
        "DGC",
        "Sub Pop"
      ],
      "master_id": 13814,
      "styles": [
        "Grunge",
        "Alternative Rock"
      ],
      "thumbnail_url": "https://i.discogs.com/thumb.jpeg",
      "title": "Nirvana - Nevermind",
      "type": "master",
      "url": "https://www.discogs.com/master/13814-Nirvana-Nevermind",
      "want": 8123,
      "year": "1991"
    }
  ],
  "returned": 1,
  "total_results": 198
}
```