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
| Action | Description | Listed price |
|---|---|---|
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. | Billed per request at your plan's rates |
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. | Billed per request at your plan's rates |
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. | 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/userInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
items | string[] | 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:
| Field | Type | Description |
|---|---|---|
id | integer | The member's Discogs id. |
username | string | — |
url | string | The member's discogs.com profile page. |
name | string | null | The real name the member chose to show. |
location | string | null | The location the member typed, free text. |
homePage | string | null | The home page the member links from their profile. |
profile | string | null | The member's profile text, in Discogs markup. |
links | string[] | Every outbound link on the profile: the home page, then the URLs in the profile text, in order, one per normalized URL. |
avatarUrl | string | null | — |
bannerUrl | string | null | — |
registered | string | null | When the member joined, ISO 8601 UTC. |
isStaff | boolean | Whether the member is Discogs staff. |
collection | integer | null | How many releases are in the member's collection; null when the collection is private. |
wantlist | integer | null | How many releases are in the member's wantlist; null when the wantlist is private. |
collectionPublic | boolean | Whether the member's collection is public, so the collection action can read it. |
wantlistPublic | boolean | Whether the member's wantlist is public, so the wantlist action can read it. |
lists | integer | How many public lists the member made. |
forSale | integer | How many items the member has for sale in the marketplace. |
releasesContributed | integer | How many releases the member submitted to the database. |
releasesRated | integer | — |
ratingAverage | number | null | The member's average release rating, out of 5; null when they rated none. |
sellerRating | number | null | The member's marketplace seller rating, as a percentage; null with no seller ratings. |
sellerRatings | integer | How many buyers rated the member as a seller. |
buyerRating | number | null | The member's marketplace buyer rating, as a percentage; null with no buyer ratings. |
buyerRatings | integer | How 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/collectionInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
user | string | Required. The member: a Discogs username, such as vinylmeplease, or a discogs.com/user/<username> URL. At least 1 character. |
pages | integer | How 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:
| Field | Type | Description |
|---|---|---|
username | string | — |
list | collection wantlist | collection or wantlist. |
url | string | The list's discogs.com page. |
private | boolean | Whether the member keeps the list private. A private list has no total and no releases. |
total | integer | null | How many releases the whole list holds; null when private. |
releases | object[] | The releases read, newest added first: up to 100 per page asked for. |
releases[].releaseId | integer | The release's Discogs id. |
releases[].releaseUrl | string | The release's discogs.com page. |
releases[].masterId | integer | null | The release's master (the work across its versions); null when it has none. |
releases[].masterUrl | string | null | The master's discogs.com page. |
releases[].instanceId | integer | null | This copy's id in the member's collection; null on the wantlist. |
releases[].dateAdded | string | null | When the member added the release to the list, ISO 8601 UTC. |
releases[].rating | integer | null | The member's rating of the release, 1 to 5; null when unrated. |
releases[].title | string | — |
releases[].year | integer | null | The release year; null when Discogs has none. |
releases[].artists | object[] | — |
releases[].artists[].id | integer | The artist's Discogs id. |
releases[].artists[].name | string | The artist's name; Discogs adds a number, such as (2), to tell same-named artists apart. |
releases[].labels | object[] | — |
releases[].labels[].id | integer | The label's Discogs id. |
releases[].labels[].name | string | — |
releases[].labels[].catalogNumber | string | null | The release's catalog number on this label. |
releases[].formats | object[] | — |
releases[].formats[].name | string | The format, such as Vinyl, CD, Cassette or File. |
releases[].formats[].quantity | string | null | How many of the format the release has, such as 2 for a double LP. |
releases[].formats[].text | string | null | Free-text detail, such as a pressing or a colour. |
releases[].formats[].descriptions | string[] | Format details, such as LP, Album, 7" or 45 RPM. |
releases[].genres | string[] | — |
releases[].styles | string[] | — |
releases[].thumbUrl | string | null | — |
releases[].coverUrl | string | 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/wantlistInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
user | string | Required. The member: a Discogs username, such as vinylmeplease, or a discogs.com/user/<username> URL. At least 1 character. |
pages | integer | How 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:
| Field | Type | Description |
|---|---|---|
username | string | — |
list | collection wantlist | collection or wantlist. |
url | string | The list's discogs.com page. |
private | boolean | Whether the member keeps the list private. A private list has no total and no releases. |
total | integer | null | How many releases the whole list holds; null when private. |
releases | object[] | The releases read, newest added first: up to 100 per page asked for. |
releases[].releaseId | integer | The release's Discogs id. |
releases[].releaseUrl | string | The release's discogs.com page. |
releases[].masterId | integer | null | The release's master (the work across its versions); null when it has none. |
releases[].masterUrl | string | null | The master's discogs.com page. |
releases[].instanceId | integer | null | This copy's id in the member's collection; null on the wantlist. |
releases[].dateAdded | string | null | When the member added the release to the list, ISO 8601 UTC. |
releases[].rating | integer | null | The member's rating of the release, 1 to 5; null when unrated. |
releases[].title | string | — |
releases[].year | integer | null | The release year; null when Discogs has none. |
releases[].artists | object[] | — |
releases[].artists[].id | integer | The artist's Discogs id. |
releases[].artists[].name | string | The artist's name; Discogs adds a number, such as (2), to tell same-named artists apart. |
releases[].labels | object[] | — |
releases[].labels[].id | integer | The label's Discogs id. |
releases[].labels[].name | string | — |
releases[].labels[].catalogNumber | string | null | The release's catalog number on this label. |
releases[].formats | object[] | — |
releases[].formats[].name | string | The format, such as Vinyl, CD, Cassette or File. |
releases[].formats[].quantity | string | null | How many of the format the release has, such as 2 for a double LP. |
releases[].formats[].text | string | null | Free-text detail, such as a pressing or a colour. |
releases[].formats[].descriptions | string[] | Format details, such as LP, Album, 7" or 45 RPM. |
releases[].genres | string[] | — |
releases[].styles | string[] | — |
releases[].thumbUrl | string | null | — |
releases[].coverUrl | string | 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.
Wayback Machine
The Internet Archive's Wayback Machine: every snapshot it holds of a URL, host or path prefix, with capture time, status and type, and an archived page as it was captured, with its title, text and links. Useful for pages that have since changed or gone.
Bluesky
Bluesky profiles, an account's posts and replies with permalinks and exact timestamps back to its first post, and account search by name or handle.