Discogs

Pricing

Rating

Developer

Actor stats

Categories

Share

⚡ For a higher maximum, pagination and more filters, please use canadesk/discogs-plus!

💡 Some data will be returned based on the IP address location, such as sales statistics and availability.

🛑 Discogs marketplace (= "Sell") is sensitive to scraping. Use your own cookies, set longer waiting times, reduce batch number and use high-quality proxies.

Input

• Keywords (array)

  Returns data for the keywords.

  Expected format:

  • Get

    • Default: ID ("32515302") or URL (https://www.discogs.com/sell/release/32515302).

    • User: Name ("discogs") or ID.

  • Sell

    • Releases: ID (32515302) or URL (https://www.discogs.com/sell/release/32515302).

    • List: Free text. Any search terms. 💡 We strongly recommend using the GTIN or barcode or ID! Discogs' search is fairly limited.

  • Search

    Free text. Any search terms ("purple rain prince").

• Custom Input (object)

  Alternative to/overrides Keywords.

  You can set a different process/category combination for each keyword.

  ⭐ For 6+ entries at a time, please use canadesk/discogs-plus!

• Process (select)

  • Get

    Returns data for the specified category. Requires a specific ID (or Name or URL).

  • Search

    Returns data for the specified category based on the search terms.

  • Sell

    Returns prices for the specified release (with statistics) or free text search.

• Category (select)

  Each Process/Category combination must be valid.

  Possible options are:

  • Get

    "artist", "artistReleases", "release", "master", "masterVersions", "label", "labelReleases", "profile", "inventory", "listing", "collectionFolders", "collectionFolder", "collectionItemsByFolder"

  • Search

    "artist", "release", "master", "label", "all"

  • Sell

    "release", "list"

• Media format (select)

  Only applicable to "Sell" for category LIST.

• Ships From / Media condition (select)

  Only applicable to "Sell".

• Currency (select)

  Only applicable to "Sell".

  • Currency filter

    Returns results sold in the specified currency.

  • Currency conversion

    Converts the total price in the specified currency (original total is still available).

• Cookie (string)

  Only for Sell. You are less likely to be blocked by providing your own cookies from Discogs marketplace.

  Leave empty for default!

• Maximum results (integer)

  Per keyword.

  ⭐ For pagination, please use canadesk/spotify-plus!

• Batch (integer)

  Number of parallel requests to be executed - only relevant when there is more than 1 keyword.

  Default is 1. The higher the number, the more chances you have to be blocked.

  💡 Make sure to increase the Actor's memory and timeout for long runs!

• Delay (integer)

  For high-volume scraping, make sure to set a reasonable waiting time.

Example Custom Input

Limited to 5 entries with this actor.

{
"input":[
{
"id":"32515302",
"process":"sell",
"category":"release"
},
{
"id":"00602508108556",
"process":"sell",
"category":"list"
},
{
"id":"https://www.discogs.com/label/1430979-Daft-Punk",
"process":"get",
"category":"label"
},
{
"id":"855971",
"process":"get",
"category":"artist"
},
{
"id":"855971",
"process":"get",
"category":"artistReleases"
},
{
"id":"daft punk",
"process":"search",
"category":"artist"
},
{
"id":"4988006799202",
"process":"search",
"category":"all"
},
{
"id":"32515302",
"process":"get",
"category":"release"
},
{
"id":"26647",
"process":"get",
"category":"master"
},
{
"id":"26647",
"process":"get",
"category":"masterVersions"
},
{
"id":"1430979",
"process":"get",
"category":"label"
},
{
"id":"1430979",
"process":"get",
"category":"labelReleases"
},
{
"id":"jamescaton",
"process":"get",
"category":"profile"
},
{
"id":"jamescaton",
"process":"get",
"category":"inventory"
},
{
"id":"3396468555",
"process":"get",
"category":"listing"
},
{
"id":"jamescaton",
"process":"get",
"category":"collectionFolders"
},
{
"id":"jamescaton",
"process":"get",
"category":"collectionFolder"
},
{
"id":"jamescaton",
"process":"get",
"category":"collectionItemsByFolder"
}
]
}

Output

Search/Release returns (category-dependent):

{
"discogsId":4723572,
"siteUrl":"https://www.discogs.com/release/4723572-Daft-Punk-Get-Lucky-Daft-Punk-Remix",
"title":"Get Lucky (Daft Punk Remix)",
"formats":[
{
"name":"Vinyl",
"quantity":"1",
"description":[
"12\"",
"33 ⅓ RPM",
"Single"
],
"text":"180 gram"
}
],
"primaryArtists":[
{
"displayName":"Daft Punk",
"nameVariation": null,
"joiningText":"",
"artist":{
"discogsId":1289,
"name":"Daft Punk"
}
}
],
"inWantlist": null,
"collectionItems": null,
"myListings":{
"totalCount":0
},
"listings":{
"totalCount":58
},
"lowestPrice":{
"converted":{
"amount":41.13,
"currency":"USD"
}
},
"images":{
"edges":[
{
"node":{
"thumbnail":{
"width":149,
"height":150,
"sourceUrl":"https://i.discogs.com/3JWdFDUGrNy21wEx55oPI2w8ZDAAyKugc2egyGaP7sg/rs:fit/g:sm/q:40/h:300/w:300/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTQ3MjM1/NzItMTM3MzUzNTc3/OS03OTk2LmpwZWc.jpeg",
"webpUrl":"https://i.discogs.com/3JWdFDUGrNy21wEx55oPI2w8ZDAAyKugc2egyGaP7sg/rs:fit/g:sm/q:40/h:300/w:300/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTQ3MjM1/NzItMTM3MzUzNTc3/OS03OTk2LmpwZWc.jpeg"
},
"nsfw":false
}
}
]
},
"type":"Release"
}

Get/LabelReleases returns:

{
"data":[
{
"status":"Accepted",
"format":"12\", Single, Promo",
"catno":"7087 6 16491 1 6, SPRO-16491",
"thumb":"",
"resource_url":"https://api.discogs.com/releases/20045",
"title":"Harder Better Faster Stronger",
"id":20045,
"year":2001,
"artist":"Daft Punk",
"uri":"https://www.discogs.com/release/20045-Harder-Better-Faster-Stronger"
},
{
"status":"Accepted",
"format":"DVD-V, Multichannel, PAL",
"catno":"VDVD8, 7243 4909529 8",
"thumb":"",
"resource_url":"https://api.discogs.com/releases/251953",
"title":"Interstella 5555 (The 5tory Of The 5ecret 5tar 5ystem)",
"id":251953,
"year":2003,
"artist":"Daft Punk & Leiji Matsumoto",
"uri":"https://www.discogs.com/release/251953-Interstella-5555-(The-5tory-Of-The-5ecret-5tar-5ystem)"
},
...
]
}

Sell/Release returns:

Statistics are available for Sell/Release. Details are available for Sell/List.

{
"keyword":"32515302",
"category":"release",
"data":{
"statistics":{
"have":3315,
"want":1334,
"avg_rating":4.91,
"ratings":167,
"last_sold":"06 Jan 25",
"lowest":111.12,
"median":159.4,
"highest":201.25,
"demand_level":"medium"
},
"prices":[
{
"uri":"https://www.discogs.com/sell/item/3398619150",
"name":"Daft Punk = ダフト・パンク* - Discovery = ディスカバリー (2xLP, Album, Ltd, RE)",
"media_condition":"Mint (M)",
"sleeve_condition":"Mint (M)",
"description":"Label:Daft Life, ADA France",
"seller":"ABpaolinobeatbitAB",
"seller_rating":4.91,
"seller_reviews":3315,
"ships_from":"Italy",
"price":740,
"shipping_fee": null,
"shipping_fee_exists":"yes, but not specified",
"total_estimate":740,
"total_estimate_currency":1099.5675,
"currency":"EUR",
"details":{							// Only available when Statistics are not provided
"availability_ip": null,			// True = Can be sent to the IP location
"unavailability_location_ip": null,	// If availability_ip is False, shows the current IP location
"label": null,
"gtin": null,
"release_link": null,
"rating": null,
"have": null,
"want": null
}
},
{
"uri":"https://www.discogs.com/sell/item/3387500613",
"name":"Daft Punk = ダフト・パンク* - Discovery = ディスカバリー (2xLP, Album, Ltd, RE)",
"media_condition":"Mint (M)",
"sleeve_condition":"Mint (M)",
"description":"Factory sealed. Hype sticker. All in perfect conditions. Fast and secured shipment. Shipping with tracking.",
"seller":"27max",
"seller_rating":4.91,
"seller_reviews":3315,
"ships_from":"Portugal",
"price":204,
"shipping_fee":23.8023,
"shipping_fee_exists":"yes",
"total_estimate":227.8023,
"total_estimate_currency":338.4919,
"currency":"EUR",
"details":{
"availability_ip": null,			// True = Can be sent to the IP location
"unavailability_location_ip": null,	// If availability_ip is False, shows the current IP location
"label": null,
"gtin": null,
"release_link": null,
"rating": null,
"have": null,
"want": null
}
},
...
]
}
}

Support

Always use high-quality proxies and set a reasonable waiting time.

Open a new issue for bugs or feature requests. Please share the run URL.

Cheers!