Spotify To Discogs Matcher

🎵 Transform your Spotify playlists into a curated Discogs collection!

This Apify Actor automatically matches every song in a Spotify playlist with corresponding releases on Discogs, the world's largest music database. Perfect for vinyl collectors, music enthusiasts, or anyone who wants to explore physical releases of their favorite digital tracks.

What It Does

Simply provide a Spotify playlist URL, and the actor will:

1. Extract all tracks from your Spotify playlist (handles playlists of any size)
2. Search Discogs for matching releases for each track
3. Find vinyl versions (optional) by checking master releases across all pressings
4. Deliver results in real-time as each track is processed

The actor processes tracks one by one and saves results immediately, so you can see progress as it happens—no need to wait until the end!

Key Features

🎯 Smart Matching

• Searches Discogs using artist and track name combinations
• Returns up to 10 potential matches per track
• Includes release details like year, country, format, label, and catalog number

💿 Vinyl Discovery (Optional)

When enabled, the actor goes the extra mile:

• Checks master releases to find if ANY version of a track exists on vinyl
• Scans through all pressings and versions (up to 30 releases per master)
• Provides direct links to vinyl-filtered master release pages
• Perfect for vinyl collectors who want to know what's available

⚡ Real-Time Results

• Results appear in the dataset as soon as each track is processed
• See progress in real-time through detailed logging
• No waiting until the end—start exploring results immediately!

How It Works

The actor follows this workflow:

1. Authentication: Connects to both Spotify and Discogs
2. Playlist Extraction: Fetches all tracks from the provided Spotify playlist URL
3. Discogs Search: For each track, searches Discogs database for matching releases
4. Vinyl Check (if enabled):
   • Identifies master releases
   • Fetches all versions in the master release
   • Checks each version's format to detect vinyl availability
5. Data Output: Saves structured results with Spotify track info and Discogs matches

Usage

Input

The actor accepts a JSON input with the following structure:

{
  "playlistUrl": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
  "checkVinyl": false
}

Input Fields

• playlistUrl (required)

  • URL or URI of the Spotify playlist to process
  • Supports both formats:
    • https://open.spotify.com/playlist/PLAYLIST_ID
    • spotify:playlist:PLAYLIST_ID

• checkVinyl (optional, default: false)

  • When true: Performs comprehensive vinyl checking by examining master releases
  • ⚠️ Note: Enabling vinyl checking requires additional API calls and will take longer

Output

The actor outputs a dataset with beautifully structured data. Each item contains:

Top-Level Fields (for easy viewing)

• artist - Artist name from Spotify
• trackName - Track name from Spotify
• discogsThumb - Cover art image from Discogs
• discogsTitle - Title of the first matching Discogs release
• discogsUrl - Direct link to the Discogs release page
• isOnVinyl - Boolean indicating if vinyl version exists (only when checkVinyl: true)
• discogsMasterUrl - Link to master release filtered for vinyl (only when checkVinyl: true and master exists)

Detailed Data (for advanced use)

• spotifyTrack - Complete Spotify track information (name, artist, album, release date, duration, etc.)
• discogsMatches - Array of all matching Discogs releases (up to 10) with full details:
  • Title, year, country
  • Format information
  • Label and catalog number
  • Discogs ID and URLs
  • Thumbnail images

Example Output

{
  "artist": "The Beatles",
  "trackName": "Here Comes The Sun",
  "discogsThumb": "https://i.discogs.com/...",
  "discogsTitle": "The Beatles - Here Comes The Sun",
  "discogsUrl": "https://www.discogs.com/release/12345678",
  "isOnVinyl": true,
  "discogsMasterUrl": "https://www.discogs.com/master/101105?redirected=true&format=Vinyl",
  "spotifyTrack": {
    "name": "Here Comes The Sun",
    "artist": "The Beatles",
    "album": "Abbey Road",
    "releaseDate": "1969-09-26",
    "spotifyId": "4Kx6ry1oxTg0F6moxuIcPK",
    "spotifyUri": "spotify:track:4Kx6ry1oxTg0F6moxuIcPK",
    "duration": 185520
  },
  "discogsMatches": [
    {
      "title": "The Beatles - Here Comes The Sun",
      "year": 1969,
      "country": "UK",
      "format": ["Vinyl", "LP", "Album"],
      "label": ["Apple Records"],
      "catalogNumber": "PCS 7088",
      "discogsId": 12345678,
      "discogsUrl": "https://www.discogs.com/release/12345678",
      "thumb": "https://i.discogs.com/...",
      "masterId": 101105
    }
  ]
}

Rate Limiting & Performance

The actor is designed to be respectful of API limits:

• Base delay: 1 second between Discogs API calls
• Adaptive delays: If the rate limit is hit, it increases delays to prevent further issues

Processing time: For a playlist with 50 tracks:

• Without vinyl checking: ~1-2 minutes
• With vinyl checking: ~5-10 minutes (depends on number of master releases)

Tips & Best Practices

1. For faster results: Keep checkVinyl: false unless you specifically need vinyl information
2. For comprehensive vinyl search: Enable checkVinyl: true to check all versions in master releases
3. Large playlists: The actor handles playlists of any size, but very large playlists (100+ tracks) will take time
4. Rate limits: If you hit rate limits frequently, the actor will automatically adjust, but you may want to process playlists in smaller batches

Support

If you encounter any issues:

• Verify the playlist URL is accessible and public
• Review the logs for detailed error messages

---

Happy matching! 🎶