Spotify Data Crawler

Extract detailed information from Spotify albums and artists using the official Spotify web API. This Actor can process up to 100 items in a single run, making it perfect for bulk data extraction.

🎵 What it does

This crawler:

• Fetches detailed album or artist data using Spotify's GraphQL API
• Processes multiple items (up to 100) in batch
• Returns structured data ready for analysis

📊 Output

The Actor returns structured data for each requested item including:

• Albums: Track listings, duration, release info, artist details
• Artists: Discography, follower count, genres, related artists

🚀 Input Configuration

Configure your crawl with these parameters:

Content Type

Choose what type of content to extract:

• album - Album information and track listings
• artist - Artist profile and discography data

Spotify IDs

Provide a list of Spotify IDs (maximum 100):

• Each ID should be exactly 22 characters
• Get IDs from Spotify URLs: https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy
• The ID is the part after the last slash: 4aawyAB9vmqN3uQ7FjRGTy

Example Input

{
  "request_type": "album", 
  "ids": [
    "4aawyAB9vmqN3uQ7FjRGTy",
    "1DFixLWuPkv3KT3TnV35m3",
    "2noRn2Aes5aoNVsU6iWThc"
  ]
}

💡 Use Cases

• Music Analytics: Analyze album performance and track popularity
• Playlist Curation: Gather detailed info for playlist recommendations
• Artist Research: Study discographies and artist relationships
• Data Analysis: Export Spotify data for research projects

📈 Performance

• Processes up to 100 items per run
• Average processing time: ~1-2 seconds per item
• Built-in rate limiting prevents API throttling
• Efficient token reuse across multiple requests

🔍 Data Quality

• Direct access to official Spotify data
• Real-time information (not cached)
• Complete track and artist metadata
• Structured JSON output format

🚀 Getting Started

1. Add your Spotify IDs to the input
2. Choose content type (album or artist)
3. Run the Actor
4. Download results from the dataset

Perfect for music industry professionals, researchers, and developers building music-related applications.