Spotify Album Scraper

Extract structured album and track data from Spotify using keywords, direct URLs, or both.

Overview

This actor scrapes detailed metadata from Spotify albums. You can search by keyword, provide specific album URLs, or combine both methods. The output is clean JSON containing album information, artist details, cover art, release dates, and track-level data. It's useful for building music applications, data analysis, or research projects.

Key Features

• Flexible Input: Search by keyword, provide album URLs, or use both methods simultaneously. Results are labeled by source (keyword or url).
• Comprehensive Album Data: Extracts album type, title, cover image URL, release date, total tracks, duration, artists, artist URLs, restrictions, and the Spotify album link.
• Detailed Track Data: Gets track title, duration, artists, artist URLs, and the track's Spotify URL for each song.
• Configurable Scraping: Control the number of results per keyword, limit tracks per album, and choose whether to include available_markets data.
• Structured Output: Returns well-organized JSON ready for integration into databases, APIs, or analysis tools.

How to Use

Configure the actor using a JSON input object. Here are the main parameters:

Input/Output

Input Configuration

{
  "searchMode": "both",
  "keywords": ["indie folk"],
  "album_urls": [
    { "url": "https://open.spotify.com/album/1CB5o6cOeGH4q1z6KJROI8" }
  ],
  "album_type": "any",
  "maxResults": 5,
  "track_limit": 10,
  "include_available_markets": false
}

Output Example

The actor returns an array of album objects. Key fields include:

[
  {
    "result_mode": "keyword",
    "input_keyword": "jazz",
    "album_title": "Example Jazz Album",
    "album_artists": ["Artist Name"],
    "album_cover": "https://i.scdn.co/image/...",
    "album_release_date": "2023-01-01",
    "total_tracks": 10,
    "album_url": "https://open.spotify.com/album/...",
    "tracks": [
      {
        "track_title": "Song Name",
        "track_duration": "3m 45s",
        "track_artists": ["Artist Name"],
        "track_url": "https://open.spotify.com/track/..."
      }
    ]
  }
]

Output Field Guide:
* result_mode: Identifies the source (keyword or url).
* album_* fields: Contain metadata about the album.
* tracks: An array of objects with details for each song.
* available_markets: Included if include_available_markets is set to true.