Spotify Albums Scraper

An Apify actor that programmatically searches Spotify and extracts structured data for albums matching given keywords. It navigates the Spotify web interface, intercepts API calls, and collects album details without requiring an official API key.

Key Features

• Keyword-Based Search: Takes a list of search terms and scrapes results from open.spotify.com/search/{keyword}/albums.
• Automatic Pagination: Handles infinite scroll by intercepting and modifying subsequent API requests to load more results.
• Stealth & Reliability: Uses Puppeteer with stealth plugins, random user agents, and configurable timeouts to mimic human browsing and avoid blocks.
• Controlled Output: Limits the number of scraped items per keyword via the maxItems input parameter.
• Structured Data Extraction: Parses JSON responses from Spotify's internal API to provide clean, usable data.

How to Use

Run the actor on the Apify platform. Provide your search keywords and an optional item limit via the input configuration (see below). The actor will launch a headless browser, perform the searches, and return the scraped album data.

Input

Configure the actor using a JSON object with the following properties:

{
  "keywords": ["rock classics", "indie 2024"],
  "maxItems": 50
}

• keywords (Array, Required): A list of search query strings.
• maxItems (Number, Optional, Default: Infinity): The maximum number of album items to scrape per keyword.

Output

The actor outputs a dataset where each item is a structured object representing an album, parsed from Spotify's internal API. The exact schema of each item depends on Spotify's data structure, but typically includes details like:

• uri / id: The Spotify URI and unique identifier for the album.
• name: The album title.
• artists: An array of artist objects (with name, uri, etc.).
• coverArt: Image URLs for the album artwork.
• date: The release year.
• type: The content type (e.g., "album").

The dataset is accessible via the Apify platform following the actor's run.