Discogs

⚡ 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!