String docs
Site integrations

Discogs

Discogs, the music database and record marketplace: a member's public profile (location, home page, profile text and the links in it, join date, collection and wantlist sizes) and the releases in their collection and wantlist, newest first, when the member made them public.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: discogs
  • Version: 1.0.0
  • Reads from: discogs.com
ActionDescriptionListed price
userRead Discogs members' public profiles: real name if shown, location, home page, profile text and every outbound link in it, avatar, join date, collection and wantlist sizes and whether each is public, lists, items for sale, database contributions, ratings, and marketplace buyer and seller ratings. Give usernames or discogs.com/user URLs.Billed per request at your plan's rates
collectionRead the releases in a Discogs member's collection, newest added first: each release's title, year, artists, labels and catalog numbers, formats, genres, styles, cover art, the member's rating and when they added it, with the release's discogs.com link. A collection the member keeps private comes back as one row with private set and no releases. Up to 100 releases a page, up to 20 pages.Billed per request at your plan's rates
wantlistRead the releases on a Discogs member's wantlist, the records they are looking for, newest added first: each release's title, year, artists, labels and catalog numbers, formats, genres, styles, cover art and when they added it, with the release's discogs.com link. A wantlist the member keeps private comes back as one row with private set and no releases. Up to 100 releases a page, up to 20 pages.Billed per request at your plan's rates

user

Read Discogs members' public profiles: real name if shown, location, home page, profile text and every outbound link in it, avatar, join date, collection and wantlist sizes and whether each is public, lists, items for sale, database contributions, ratings, and marketplace buyer and seller ratings. Give usernames or discogs.com/user URLs.

POST https://request.usestring.ai/v1/integrations/discogs/user

Input

Unknown fields are rejected.

FieldTypeDescription
itemsstring[]Required. The members: each a Discogs username, such as vinylmeplease, or a discogs.com/user/<username> URL. 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idintegerThe member's Discogs id.
usernamestring—
urlstringThe member's discogs.com profile page.
namestring | nullThe real name the member chose to show.
locationstring | nullThe location the member typed, free text.
homePagestring | nullThe home page the member links from their profile.
profilestring | nullThe member's profile text, in Discogs markup.
linksstring[]Every outbound link on the profile: the home page, then the URLs in the profile text, in order, one per normalized URL.
avatarUrlstring | null—
bannerUrlstring | null—
registeredstring | nullWhen the member joined, ISO 8601 UTC.
isStaffbooleanWhether the member is Discogs staff.
collectioninteger | nullHow many releases are in the member's collection; null when the collection is private.
wantlistinteger | nullHow many releases are in the member's wantlist; null when the wantlist is private.
collectionPublicbooleanWhether the member's collection is public, so the collection action can read it.
wantlistPublicbooleanWhether the member's wantlist is public, so the wantlist action can read it.
listsintegerHow many public lists the member made.
forSaleintegerHow many items the member has for sale in the marketplace.
releasesContributedintegerHow many releases the member submitted to the database.
releasesRatedinteger—
ratingAveragenumber | nullThe member's average release rating, out of 5; null when they rated none.
sellerRatingnumber | nullThe member's marketplace seller rating, as a percentage; null with no seller ratings.
sellerRatingsintegerHow many buyers rated the member as a seller.
buyerRatingnumber | nullThe member's marketplace buyer rating, as a percentage; null with no buyer ratings.
buyerRatingsintegerHow many sellers rated the member as a buyer.

Example

curl https://request.usestring.ai/v1/integrations/discogs/user \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["https://www.discogs.com/user/vinylmeplease", "Discogs"]
  }'

data starts with these rows:

[
  {
    "id": 1658606,
    "username": "vinylmeplease",
    "url": "https://www.discogs.com/user/vinylmeplease",
    "name": null,
    "location": "Hammond,in",
    "homePage": null,
    "profile": null,
    "links": [],
    "avatarUrl": "https://gravatar.com/avatar/82f84ae03b07857c0c5d4b95854f4d6b2fc1a8e2fcdff8fe35505f01a14c8f4f?s=500&r=pg&d=mm",
    "bannerUrl": null,
    "registered": "2012-11-18T18:03:10Z",
    "isStaff": false,
    "collection": 157,
    "wantlist": 80,
    "collectionPublic": true,
    "wantlistPublic": true,
    "lists": 0,
    "forSale": 0,
    "releasesContributed": 1,
    "releasesRated": 0,
    "ratingAverage": null,
    "sellerRating": null,
    "sellerRatings": 0,
    "buyerRating": null,
    "buyerRatings": 0
  },
  {
    "id": 1000,
    "username": "discogs",
    "url": "https://www.discogs.com/user/discogs",
    "name": null,
    "location": "Portland",
    "homePage": "http://www.discogs.com",
    "profile": null,
    "links": ["http://www.discogs.com"],
    "avatarUrl": "https://i.discogs.com/XL5Jg1sWIh9xPWQ686t-fi4AMYbjxlIMxYXwkyOoOqA/rs:fill/g:sm/q:40/h:500/w:500/czM6Ly9kaXNjb2dz/LXVzZXItYXZhdGFy/cy9VLTEwMDAtMTQ0/NzE4MDA5Ni5wbmc.jpeg",
    "bannerUrl": null,
    "registered": "2000-10-31T08:00:00Z",
    "isStaff": true,
    "collection": null,
    "wantlist": null,
    "collectionPublic": false,
    "wantlistPublic": false,
    "lists": 185,
    "forSale": 0,
    "releasesContributed": 0,
    "releasesRated": 191,
    "ratingAverage": 4.01,
    "sellerRating": null,
    "sellerRatings": 0,
    "buyerRating": null,
    "buyerRatings": 0
  }
]

Requests and billing

  • Requests: 1 Web Access request per entry in items.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

collection

Read the releases in a Discogs member's collection, newest added first: each release's title, year, artists, labels and catalog numbers, formats, genres, styles, cover art, the member's rating and when they added it, with the release's discogs.com link. A collection the member keeps private comes back as one row with private set and no releases. Up to 100 releases a page, up to 20 pages.

POST https://request.usestring.ai/v1/integrations/discogs/collection

Input

Unknown fields are rejected.

FieldTypeDescription
userstringRequired. The member: a Discogs username, such as vinylmeplease, or a discogs.com/user/<username> URL. At least 1 character.
pagesintegerHow many pages of up to 100 releases to read, newest added first, from 1 to 20. Defaults to 1. From 1 to 20.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
usernamestring—
listcollection wantlistcollection or wantlist.
urlstringThe list's discogs.com page.
privatebooleanWhether the member keeps the list private. A private list has no total and no releases.
totalinteger | nullHow many releases the whole list holds; null when private.
releasesobject[]The releases read, newest added first: up to 100 per page asked for.
releases[].releaseIdintegerThe release's Discogs id.
releases[].releaseUrlstringThe release's discogs.com page.
releases[].masterIdinteger | nullThe release's master (the work across its versions); null when it has none.
releases[].masterUrlstring | nullThe master's discogs.com page.
releases[].instanceIdinteger | nullThis copy's id in the member's collection; null on the wantlist.
releases[].dateAddedstring | nullWhen the member added the release to the list, ISO 8601 UTC.
releases[].ratinginteger | nullThe member's rating of the release, 1 to 5; null when unrated.
releases[].titlestring—
releases[].yearinteger | nullThe release year; null when Discogs has none.
releases[].artistsobject[]—
releases[].artists[].idintegerThe artist's Discogs id.
releases[].artists[].namestringThe artist's name; Discogs adds a number, such as (2), to tell same-named artists apart.
releases[].labelsobject[]—
releases[].labels[].idintegerThe label's Discogs id.
releases[].labels[].namestring—
releases[].labels[].catalogNumberstring | nullThe release's catalog number on this label.
releases[].formatsobject[]—
releases[].formats[].namestringThe format, such as Vinyl, CD, Cassette or File.
releases[].formats[].quantitystring | nullHow many of the format the release has, such as 2 for a double LP.
releases[].formats[].textstring | nullFree-text detail, such as a pressing or a colour.
releases[].formats[].descriptionsstring[]Format details, such as LP, Album, 7" or 45 RPM.
releases[].genresstring[]—
releases[].stylesstring[]—
releases[].thumbUrlstring | null—
releases[].coverUrlstring | null—

Example

curl https://request.usestring.ai/v1/integrations/discogs/collection \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "vinylmeplease",
    "pages": 1
  }'

data starts with these rows:

[
  {
    "username": "vinylmeplease",
    "list": "collection",
    "url": "https://www.discogs.com/user/vinylmeplease/collection",
    "private": false,
    "total": 157,
    "releases": [
      {
        "releaseId": 4283496,
        "releaseUrl": "https://www.discogs.com/release/4283496",
        "masterId": 487619,
        "masterUrl": "https://www.discogs.com/master/487619",
        "instanceId": 194959103,
        "dateAdded": "2016-10-29T08:01:59Z",
        "rating": null,
        "title": "A Day In Copenhagen",
        "year": 1980,
        "artists": [
          {
            "id": 145263,
            "name": "Dexter Gordon"
          },
          {
            "id": 372549,
            "name": "Slide Hampton"
          }
        ],
        "labels": [
          {
            "id": 91009,
            "name": "Pausa Records",
            "catalogNumber": "PR 7058"
          }
        ],
        "formats": [
          {
            "name": "Vinyl",
            "quantity": "1",
            "text": null,
            "descriptions": ["LP", "Album", "Reissue"]
          }
        ],
        "genres": ["Jazz"],
        "styles": ["Hard Bop", "Post Bop"],
        "thumbUrl": "https://i.discogs.com/_9jqGWaklPN8P0r0uVqOZELMYiHcb1D_XgCuCnD9mMc/rs:fit/g:sm/q:40/h:150/w:150/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTQyODM0/OTYtMTUzMTcwODU4/Mi03NzM0LmpwZWc.jpeg",
        "coverUrl": "https://i.discogs.com/R_eFcKXvkWPXCVrOMXUErsfC5W7DguQeL-6Beq9UKvg/rs:fit/g:sm/q:90/h:600/w:598/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTQyODM0/OTYtMTUzMTcwODU4/Mi03NzM0LmpwZWc.jpeg"
      },
      {
        "releaseId": 262760,
        "releaseUrl": "https://www.discogs.com/release/262760",
        "masterId": null,
        "masterUrl": null,
        "instanceId": 194959007,
        "dateAdded": "2016-10-29T08:00:31Z",
        "rating": null,
        "title": "Dub Plate Sessions",
        "year": 1997,
        "artists": [
          {
            "id": 22512,
            "name": "Surreal Fields"
          }
        ],
        "labels": [
          {
            "id": 2060,
            "name": "Mindfood Records",
            "catalogNumber": "MF 030"
          }
        ],
        "formats": [
          {
            "name": "Vinyl",
            "quantity": "1",
            "text": null,
            "descriptions": ["12\""]
          }
        ],
        "genres": ["Electronic"],
        "styles": ["House"],
        "thumbUrl": "https://i.discogs.com/SHiFaDsqzrnT358-eud1vK26i_M0XTs7gBrhThvin4o/rs:fit/g:sm/q:40/h:150/w:150/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTI2Mjc2/MC0xNTY3NzIyNzkw/LTkxOTUuanBlZw.jpeg",
        "coverUrl": "https://i.discogs.com/EdIIlGtHk2BYZ3-Q5f9boTFi2-XRj9Lr5yVPdQ8qYd0/rs:fit/g:sm/q:90/h:450/w:465/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTI2Mjc2/MC0xNTY3NzIyNzkw/LTkxOTUuanBlZw.jpeg"
      },
      {
        "releaseId": 1221826,
        "releaseUrl": "https://www.discogs.com/release/1221826",
        "masterId": 242015,
        "masterUrl": "https://www.discogs.com/master/242015",
        "instanceId": 194958872,
        "dateAdded": "2016-10-29T07:58:45Z",
        "rating": null,
        "title": "Mighty Love",
        "year": 1974,
        "artists": [
          {
            "id": 82735,
            "name": "Spinners"
          }
        ],
        "labels": [
          {
            "id": 681,
            "name": "Atlantic",
            "catalogNumber": "SD 7296"
          }
        ],
        "formats": [
          {
            "name": "Vinyl",
            "quantity": "1",
            "text": "PR - Presswell Pressing",
            "descriptions": ["LP", "Album", "Stereo"]
          }
        ],
        "genres": ["Funk / Soul"],
        "styles": ["Soul"],
        "thumbUrl": "https://i.discogs.com/WGldxeV-nsDKDbiU8NO7WlcRDZzdskR27brfJxDg0nU/rs:fit/g:sm/q:40/h:150/w:150/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTEyMjE4/MjYtMTUxNjgxMTEx/Ny0zNDM1LmpwZWc.jpeg",
        "coverUrl": "https://i.discogs.com/XDOxYgYNjPF-BzkMb873zl53uaN0UQv7kHCWGDqKyaA/rs:fit/g:sm/q:90/h:600/w:597/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTEyMjE4/MjYtMTUxNjgxMTEx/Ny0zNDM1LmpwZWc.jpeg"
      }
    ]
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

wantlist

Read the releases on a Discogs member's wantlist, the records they are looking for, newest added first: each release's title, year, artists, labels and catalog numbers, formats, genres, styles, cover art and when they added it, with the release's discogs.com link. A wantlist the member keeps private comes back as one row with private set and no releases. Up to 100 releases a page, up to 20 pages.

POST https://request.usestring.ai/v1/integrations/discogs/wantlist

Input

Unknown fields are rejected.

FieldTypeDescription
userstringRequired. The member: a Discogs username, such as vinylmeplease, or a discogs.com/user/<username> URL. At least 1 character.
pagesintegerHow many pages of up to 100 releases to read, newest added first, from 1 to 20. Defaults to 1. From 1 to 20.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
usernamestring—
listcollection wantlistcollection or wantlist.
urlstringThe list's discogs.com page.
privatebooleanWhether the member keeps the list private. A private list has no total and no releases.
totalinteger | nullHow many releases the whole list holds; null when private.
releasesobject[]The releases read, newest added first: up to 100 per page asked for.
releases[].releaseIdintegerThe release's Discogs id.
releases[].releaseUrlstringThe release's discogs.com page.
releases[].masterIdinteger | nullThe release's master (the work across its versions); null when it has none.
releases[].masterUrlstring | nullThe master's discogs.com page.
releases[].instanceIdinteger | nullThis copy's id in the member's collection; null on the wantlist.
releases[].dateAddedstring | nullWhen the member added the release to the list, ISO 8601 UTC.
releases[].ratinginteger | nullThe member's rating of the release, 1 to 5; null when unrated.
releases[].titlestring—
releases[].yearinteger | nullThe release year; null when Discogs has none.
releases[].artistsobject[]—
releases[].artists[].idintegerThe artist's Discogs id.
releases[].artists[].namestringThe artist's name; Discogs adds a number, such as (2), to tell same-named artists apart.
releases[].labelsobject[]—
releases[].labels[].idintegerThe label's Discogs id.
releases[].labels[].namestring—
releases[].labels[].catalogNumberstring | nullThe release's catalog number on this label.
releases[].formatsobject[]—
releases[].formats[].namestringThe format, such as Vinyl, CD, Cassette or File.
releases[].formats[].quantitystring | nullHow many of the format the release has, such as 2 for a double LP.
releases[].formats[].textstring | nullFree-text detail, such as a pressing or a colour.
releases[].formats[].descriptionsstring[]Format details, such as LP, Album, 7" or 45 RPM.
releases[].genresstring[]—
releases[].stylesstring[]—
releases[].thumbUrlstring | null—
releases[].coverUrlstring | null—

Example

curl https://request.usestring.ai/v1/integrations/discogs/wantlist \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "vinylmeplease",
    "pages": 1
  }'

data starts with these rows:

[
  {
    "username": "vinylmeplease",
    "list": "wantlist",
    "url": "https://www.discogs.com/user/vinylmeplease/wantlist",
    "private": false,
    "total": 80,
    "releases": [
      {
        "releaseId": 1534289,
        "releaseUrl": "https://www.discogs.com/release/1534289",
        "masterId": 157520,
        "masterUrl": "https://www.discogs.com/master/157520",
        "instanceId": null,
        "dateAdded": "2013-01-11T06:46:23Z",
        "rating": null,
        "title": "Reality Check",
        "year": 2006,
        "artists": [
          {
            "id": 137603,
            "name": "Juvenile (2)"
          }
        ],
        "labels": [
          {
            "id": 681,
            "name": "Atlantic",
            "catalogNumber": "83790-1"
          }
        ],
        "formats": [
          {
            "name": "Vinyl",
            "quantity": "2",
            "text": null,
            "descriptions": ["LP", "Album"]
          }
        ],
        "genres": ["Hip Hop"],
        "styles": ["Gangsta", "Bounce"],
        "thumbUrl": "https://i.discogs.com/Vmyz_rVVWjEOudXRPSnYLep_pxmCHfu-bUOZyiJtXFo/rs:fit/g:sm/q:40/h:150/w:150/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTE1MzQy/ODktMTIyNjY2MDkw/NS5qcGVn.jpeg",
        "coverUrl": "https://i.discogs.com/gQvQGqBoB621QCnN9nem8HlLd3Hm3Zi_LmISAvaQmNA/rs:fit/g:sm/q:90/h:497/w:500/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTE1MzQy/ODktMTIyNjY2MDkw/NS5qcGVn.jpeg"
      },
      {
        "releaseId": 1619183,
        "releaseUrl": "https://www.discogs.com/release/1619183",
        "masterId": 157523,
        "masterUrl": "https://www.discogs.com/master/157523",
        "instanceId": null,
        "dateAdded": "2013-01-11T06:45:22Z",
        "rating": null,
        "title": "Juve The Great",
        "year": 2003,
        "artists": [
          {
            "id": 137603,
            "name": "Juvenile (2)"
          }
        ],
        "labels": [
          {
            "id": 19799,
            "name": "Cash Money Records",
            "catalogNumber": "B0001718-01"
          },
          {
            "id": 796,
            "name": "Universal Records",
            "catalogNumber": "B0001718-01"
          }
        ],
        "formats": [
          {
            "name": "Vinyl",
            "quantity": "2",
            "text": null,
            "descriptions": ["LP", "Album"]
          }
        ],
        "genres": ["Hip Hop"],
        "styles": ["Bounce"],
        "thumbUrl": "https://i.discogs.com/LeSF3nBpXa-HFwR5c3osvbVvWGp3nkxrMnLUDL2rDLs/rs:fit/g:sm/q:40/h:150/w:150/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTE2MTkx/ODMtMTM1NTY2OTUw/MS01MDg4LmpwZWc.jpeg",
        "coverUrl": "https://i.discogs.com/nNqSLeyeLazEOrRTHq9a9meQBYFkbJR4q4J1H2BbJZ8/rs:fit/g:sm/q:90/h:600/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTE2MTkx/ODMtMTM1NTY2OTUw/MS01MDg4LmpwZWc.jpeg"
      },
      {
        "releaseId": 3157019,
        "releaseUrl": "https://www.discogs.com/release/3157019",
        "masterId": 367724,
        "masterUrl": "https://www.discogs.com/master/367724",
        "instanceId": null,
        "dateAdded": "2013-01-11T06:43:37Z",
        "rating": null,
        "title": "Tha Carter IV",
        "year": 2011,
        "artists": [
          {
            "id": 1065010,
            "name": "Lil Wayne"
          }
        ],
        "labels": [
          {
            "id": 19799,
            "name": "Cash Money Records",
            "catalogNumber": "B0016057-01"
          },
          {
            "id": 166429,
            "name": "Young Money Entertainment",
            "catalogNumber": "B0016057-01"
          },
          {
            "id": 81846,
            "name": "Universal Republic Records",
            "catalogNumber": "B0016057-01"
          }
        ],
        "formats": [
          {
            "name": "Vinyl",
            "quantity": "2",
            "text": "Red Translucent",
            "descriptions": ["LP", "Album", "Deluxe Edition"]
          }
        ],
        "genres": ["Hip Hop"],
        "styles": ["Gangsta", "Pop Rap"],
        "thumbUrl": "https://i.discogs.com/mQrgTqUFAadRTduQTvBh27BDR9NKQWxQf8LJvViXQBo/rs:fit/g:sm/q:40/h:150/w:150/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTMxNTcw/MTktMTczMzIzNjcw/OS05NjI4LmpwZWc.jpeg",
        "coverUrl": "https://i.discogs.com/mogg9rJl4aP-OdgLpDrZxdfDKv08GUkaED-9BxUQ4hI/rs:fit/g:sm/q:90/h:587/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTMxNTcw/MTktMTczMzIzNjcw/OS05NjI4LmpwZWc.jpeg"
      }
    ]
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.