Discogs Actor

Scrapes data from Discogs, the music database and marketplace. Supports retrieving artist, release, label, and profile information, searching the catalog, and fetching marketplace sales listings.

Overview

This actor extracts structured data from Discogs.com. It can perform three main actions (Get, Search, Sell) across various Discogs categories. For larger jobs requiring pagination, more filters, or higher limits, use canadesk/discogs-plus.

Note on Scraping: The Discogs marketplace ("Sell") is particularly sensitive. To avoid blocks, use your own cookies, set longer delays, reduce batch size, and employ high-quality proxies. Some data (like sales stats) may vary based on your IP location.

Key Features

• Multiple Processes: Get specific items by ID/URL, Search the database, or Sell to fetch marketplace prices.
• Broad Category Support:
  • Get: artist, artistReleases, release, master, masterVersions, label, labelReleases, profile, inventory, listing, collectionFolders, collectionFolder, collectionItemsByFolder.
  • Search: artist, release, master, label, all.
  • Sell: release (by ID), list (by free-text search).
• Marketplace Filters: For Sell process, filter by media format, shipping origin, media condition, and currency.
• Custom Input: Define specific process/category combinations for each query item.

How to Use

You can run the actor using a simple Keywords array or a more precise Custom Input object.

Input Methods

1. Keywords Array: Provide an array of IDs, URLs, or search terms. The actor uses a default process/category.
2. Custom Input Object: Recommended for control. Specify process and category for each entry. Overrides the Keywords method.

Limit: This actor handles up to 5 entries at a time. For 6+ entries, use canadesk/discogs-plus.

Input Configuration

• Process (Get|Search|Sell): The action to perform.
• Category: Must be a valid combination for the chosen Process (see list above).
• ID: The target identifier. This can be a numeric ID, a URL, a username (for profiles), or free-text search terms depending on the Process/Category.
  • Tip for Sell -> list and Search: Discogs search is limited. For best results, use a GTIN/barcode or release ID instead of text.
• Cookie (string): For Sell process only. Providing your authenticated Discogs cookies significantly reduces blocking risk. Leave empty to use a default.
• Maximum Results (integer): Limits results per keyword.
• Batch (integer): Number of parallel requests (default: 1). Higher values increase speed but also blocking risk. Adjust memory/timeout for large batches.
• Delay (integer): Waiting time (in ms) between requests. Crucial for high-volume scraping.

Example Custom Input

{
  "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": "daft punk",
      "process": "search",
      "category": "artist"
    }
  ]
}

Output

The actor returns a dataset containing structured items. Each item's fields depend on the Process and Category used. Typical output includes details like title, artist, year, format, tracklist, marketplace prices, seller information, and user profile data.