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.

Actions

Action	What it does
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.
Get collection value	Get what a collection is worth, as the minimum, median and maximum Discogs estimates from its marketplace history.
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.
Get list	Get one Discogs list and everything on it, with the note its curator wrote against each entry.
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.
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.
Get my identity	Get the Discogs account this connection is signed in as.
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.
Get release rating	Get how Discogs' members have rated one release: the average out of five and how many people voted.
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.
List artist releases	List an artist's discography.
List collection folders	List the folders a member's collection is filed into, with how many records are in each.
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.
List label releases	List a label's catalogue, in catalogue-number order, with the artist, title, year and format of each record it issued.
List master release versions	List every pressing of one album - each issue, reissue and repress, with its country, year, format, label and catalogue number.
List user contributions	List the releases a member has contributed edits to, whether or not they first submitted them.
List user lists	List a member's Discogs lists - the groupings they curate, such as a wants shortlist or a best-of.
List user submissions	List the artists, labels and releases a member has added to the Discogs database, newest first.
List wantlist	List the records on a member's wantlist, each with when it was added and the rating they gave it.
Search the database	Search Discogs' music database for releases, albums, artists or labels.

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 IDartist_idnumberRequired: The Discogs artist ID - the number in an artist's web address, as in discogs.com/artist/125246.At least 1.

Outputs

aliaseslist: Other names the same person records under
data_qualitytext: How complete Discogs considers the entry
groupslist: For a person, the groups they play in
idnumber: The artist's Discogs ID
image_countnumber: How many images there are
image_urltext: Link to the main image
memberslist: For a group, who is (or was) in it
nametext: The artist's name
name_variationslist: Other spellings the name appears under
profiletext: A short biography written by members
real_nametext: Their real name, for a performing alias
thumbnail_urltext: Link to a 150px thumbnail
urltext: Link to the artist on Discogs
urlslist: The artist's own sites and profiles

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.

Outputs

maximumtext: The high estimate, formatted
maximum_valuenumber: The high estimate as a number
mediantext: The middle estimate, formatted
median_valuenumber: The middle estimate as a number
minimumtext: The low estimate, formatted in the owner's currency
minimum_valuenumber: The low estimate as a number, for arithmetic
usernametext: Whose collection was valued

Example output

{
  "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 IDlabel_idnumberRequired: The Discogs label ID - the number in a label's web address, as in discogs.com/label/29377.At least 1.

Outputs

contact_infotext: The label's address and contact details
data_qualitytext: How complete Discogs considers the entry
idnumber: The label's Discogs ID
image_countnumber: How many images there are
image_urltext: Link to the main image
nametext: The label's name
parent_labelobject: The label group this one belongs to, if any
profiletext: A short history written by members
sublabelslist: The imprints this label runs
thumbnail_urltext: Link to a 150px thumbnail
urltext: Link to the label on Discogs
urlslist: The label's own sites and profiles

Example output

{
  "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 IDlist_idnumberRequired: 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_addedtext: When it was created
date_changedtext: When it last changed
descriptiontext: What the list is for
idnumber: The list's Discogs ID
image_urltext: Link to the list's own image
item_countnumber: How many entries are on the list
itemslist: What is on the list, in the curator's order
nametext: The list's name
ownertext: The username of whoever curates it
publictrue/false: Whether anyone can see it
urltext: Link to the list on Discogs

Example output

{
  "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 IDrelease_idnumberRequired: 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 currencycurrencytext: 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_saletrue/false: Whether Discogs blocks this release from being sold
currencytext: The currency the price is quoted in
lowest_pricenumber: The cheapest asking price, or null if none
num_for_salenumber: How many copies are listed for sale
release_idnumber: The release these prices are for
urltext: Link to the release's marketplace listings

Example output

{
  "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 IDmaster_idnumberRequired: 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

artisttext: The credited artist, as one line
artistslist: The credited artists, in the order they are printed
data_qualitytext: How complete Discogs considers the entry
genreslist: Its genres
idnumber: The master release's ID
image_countnumber: How many images there are
image_urltext: Link to the main image
lowest_pricenumber: The cheapest copy of any pressing
main_release_idnumber: The pressing Discogs treats as definitive - pass this to Get release
most_recent_release_idnumber: The most recently issued pressing
num_for_salenumber: How many copies are listed across all pressings
styleslist: Its styles
thumbnail_urltext: Link to a 150px thumbnail
titletext: The album title
tracklistlist: The track listing, in order
urltext: Link to the album on Discogs
videoslist: Videos members have linked to this album
yearnumber: The year the album first came out

Example output

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

idnumber: The account's Discogs ID
urltext: Link to the account's Discogs profile
usernametext: The account's username

Example output

{
  "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 IDrelease_idnumberRequired: 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 currencycurrencytext: 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

artisttext: The credited artist, as one line
artistslist: The credited artists, in the order they are printed
communityobject: What Discogs' members report about it
companieslist: The companies behind it - pressing plants, distributors, copyright holders
countrytext: Where this pressing was issued
creditslist: Everyone else credited - producers, engineers, players, designers - with their roles
data_qualitytext: How complete Discogs considers the entry
formattext: The formats as one line
formatslist: The physical or digital formats it was issued on
genreslist: Its genres
idnumber: The release's Discogs ID
identifierslist: Codes printed on the record - barcodes, matrix and runout etchings, label codes, rights society marks
image_countnumber: How many images there are
image_urltext: Link to the main image
labelslist: The labels that issued it, each with its catalogue number
lowest_pricenumber: The cheapest copy currently listed
master_idnumber: The album this is a pressing of
notestext: Members' notes about this pressing
num_for_salenumber: How many copies are listed for sale now
releasedtext: The release date as Discogs holds it, which may be partial, as in '1987-07-00'
released_formattedtext: The same date written out, as in 'Jul 1987'
statustext: Whether the entry is accepted or still in draft
styleslist: Its styles
thumbnail_urltext: Link to a 150px thumbnail
titletext: The release title
tracklistlist: The track listing, in order
urltext: Link to the release on Discogs
videoslist: Videos members have linked to this release
yearnumber: The year it was issued

Example output

{
  "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 IDrelease_idnumberRequired: 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

averagenumber: The average rating, out of five
countnumber: How many members have rated it
release_idnumber: The release that was rated
urltext: Link to the release on Discogs

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.

Outputs

avatar_urltext: Link to their avatar
buyer_num_ratingsnumber: How many sellers have rated them
buyer_ratingnumber: Their buyer rating, as a percentage
home_pagetext: Their own website, when set
idnumber: The member's Discogs ID
locationtext: Where they are
nametext: Their display name, when set
num_collectionnumber: How many records are in their collection
num_for_salenumber: How many records they have for sale
num_listsnumber: How many lists they keep
num_wantlistnumber: How many are on their wantlist
profiletext: The bio on their profile
rating_avgnumber: The average rating they give
registeredtext: When they joined Discogs
releases_contributednumber: How many database entries they contributed to
releases_ratednumber: How many releases they have rated
seller_num_ratingsnumber: How many buyers have rated them
seller_ratingnumber: Their seller rating, as a percentage
urltext: Link to their Discogs profile
usernametext: Their username

Example output

{
  "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 IDartist_idnumberRequired: The Discogs artist ID - the number in an artist's web address, as in discogs.com/artist/125246.At least 1.
Sort bysorttext: Which field to sort the discography by. Leave blank for Discogs' own order.One of: year, title, format.
Sort directionsort_ordertext: 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 resultslimitnumber: 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_idnumber: The artist whose discography this is
releaseslist: The discography
returnednumber: How many rows this step returned
total_releasesnumber: How many rows the discography has in total

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.

Outputs

folderslist: The folders, 'All' first
usernametext: Whose collection this is

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
Folderfolder_idnumber: 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 bysorttext: 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 directionsort_ordertext: 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 resultslimitnumber: 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_idnumber: Which folder was read
itemslist: The records in the folder
returnednumber: How many records this step returned
total_itemsnumber: How many are in the folder in total
usernametext: Whose collection this is

Example output

{
  "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 IDlabel_idnumberRequired: The Discogs label ID - the number in a label's web address, as in discogs.com/label/29377.At least 1.
Maximum resultslimitnumber: 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_idnumber: The label whose catalogue this is
releaseslist: The catalogue
returnednumber: How many releases this step returned
total_releasesnumber: How many the label has issued in total

Example output

{
  "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 IDmaster_idnumberRequired: 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.
Formatrelease_formattext: Only list pressings on this format, such as 'Vinyl' or 'CD'.
Labellabeltext: Only list pressings issued by this label.
Year releasedreleasedtext: Only list pressings issued in this year.
Countrycountrytext: Only list pressings issued in this country.
Sort bysorttext: 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 directionsort_ordertext: 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 resultslimitnumber: 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_idnumber: The album these pressings belong to
returnednumber: How many pressings this step returned
total_versionsnumber: How many pressings there are in total
versionslist: The pressings

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
Sort bysorttext: 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 directionsort_ordertext: 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 resultslimitnumber: 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

contributionslist: The releases they have edited
returnednumber: How many contributions this step returned
total_contributionsnumber: How many they have made in total
usernametext: Whose contributions these are

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
Maximum resultslimitnumber: 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

listslist: Their lists
returnednumber: How many lists this step returned
total_listsnumber: How many they keep in total
usernametext: Whose lists these are

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
Maximum resultslimitnumber: 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

returnednumber: How many submissions this step returned
submissionslist: What they added to the database
total_submissionsnumber: How many they have made in total
usernametext: Whose submissions these are

Example output

{
  "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 usernameusernametext: Whose account to read. Leave blank for the connected account - the one whose personal access token this connection uses.
Sort bysorttext: 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 directionsort_ordertext: 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 resultslimitnumber: 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

returnednumber: How many records this step returned
total_wantsnumber: How many are on the wantlist in total
usernametext: Whose wantlist this is
wantslist: The records they want

Example output

{
  "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 textquerytext: What to search for. Matches across titles, artists and labels. Leave blank to search by the filters alone.
Search forsearch_typetext: 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 nameartisttext: Only match records credited to this artist.
Release titlerelease_titletext: Only match records with this title.
Label namelabeltext: Only match records issued by this label.
Genregenretext: Only match this genre - Discogs' broad category, such as 'Rock', 'Electronic' or 'Jazz'.
Stylestyletext: Only match this style - the narrower classification under a genre, such as 'Grunge' or 'Deep House'.
Countrycountrytext: Only match records issued in this country.
Yearyeartext: Only match records issued in this year.
Formatformattext: Only match this format, such as 'Vinyl', 'CD', 'Cassette' or 'Album'.
Catalogue numbercatalog_numbertext: Only match this catalogue number - the label's own reference, printed on the spine or label.
Barcodebarcodetext: 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 titletracktext: Only match records containing a track with this title.
Creditcredittext: Only match records crediting this person anywhere - a producer, engineer or session player, not just the billed artist.
Maximum resultslimitnumber: 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

resultslist: The matches, most relevant first
returnednumber: How many results this step returned
total_resultsnumber: How many matches Discogs found in total

Example output

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

ActionsCopy Anchor Link

Get artistCopy Anchor Link

Inputs

Outputs

Get collection valueCopy Anchor Link

Inputs

Outputs

Get labelCopy Anchor Link

Inputs

Outputs

Get listCopy Anchor Link

Inputs

Outputs

Get marketplace statsCopy Anchor Link

Inputs

Outputs

Get master releaseCopy Anchor Link

Inputs

Outputs

Get my identityCopy Anchor Link

Inputs

Outputs

Get releaseCopy Anchor Link

Inputs

Outputs

Get release ratingCopy Anchor Link

Inputs

Outputs

Get user profileCopy Anchor Link

Inputs

Outputs

List artist releasesCopy Anchor Link

Inputs

Outputs

List collection foldersCopy Anchor Link

Inputs

Outputs

List collection itemsCopy Anchor Link

Inputs

Outputs

List label releasesCopy Anchor Link

Inputs

Outputs

List master release versionsCopy Anchor Link

Inputs

Outputs

List user contributionsCopy Anchor Link

Inputs

Outputs

List user listsCopy Anchor Link

Inputs

Outputs

List user submissionsCopy Anchor Link

Inputs

Outputs

List wantlistCopy Anchor Link

Inputs

Outputs

Search the databaseCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get artist

Get collection value

Get label

Get list

Get marketplace stats

Get master release

Get my identity

Get release

Get release rating

Get user profile

List artist releases

List collection folders

List collection items

List label releases

List master release versions

List user contributions

List user lists

List user submissions

List wantlist

Search the database