---

🎧 Spotify Album Scraper 🔍 | Extract Detailed Album & Track Data from Spotify

🚀 Overview

The Spotify Album Scraper is a powerful and efficient tool that helps you extract rich and structured data from Spotify albums using either keyword-based search, direct album URLs, or both!

Whether you're building a music app, analyzing albums and track performance, or collecting clean music data for research, this scraper gives you deep access to album metadata, artist links, cover images, release dates, restrictions, available markets, and detailed track-level data.

✨ Supports both keyword and URL input, and even lets you control inclusion of available market data!

📧 Need a custom Spotify scraper? Reach out: scrapearchitect@gmail.com

---

🔑 Key Features

🎼 Multi-Input Mode
✔️ Search by keyword, supply album URLs, or do both simultaneously
✔️ Smart labeling: See if the data came from a keyword or URL input

🧾 Complete Album Metadata
✔️ Album Type (album, single, compilation)
✔️ Album Title
✔️ Album Cover (Image URL)
✔️ Album Release Date
✔️ Total Tracks
✔️ Total Duration for Requested Tracks
✔️ Album Artists & Artist URLs
✔️ Restrictions (e.g., streaming limitations)
✔️ Available Markets (optional toggle)
✔️ Spotify Album URL

🎧 Track-Level Insights
✔️ Track Title
✔️ Track Duration
✔️ Track Artists & Artist URLs
✔️ Track Spotify URL

⚙️ Fully Configurable Input
✔️ Set maximum results per keyword
✔️ Set limit for number of tracks per album
✔️ Choose whether to include available markets
✔️ Mix both URL & keyword input for flexibility

📦 Clean JSON Output
✔️ Structured, readable data — ready for APIs, databases, or analysis tools

---

🛠 Input Configuration

Use the following JSON format to control the scraper’s behavior:

1{
2  "album_type": "any",
3  "album_urls": [
4    {
5      "url": "https://open.spotify.com/album/1CB5o6cOeGH4q1z6KJROI8",
6      "method": "GET"
7    }
8  ],
9  "include_available_markets": true,
10  "keywords": [
11    "jazz"
12  ],
13  "maxResults": 1,
14  "searchMode": "both",
15  "track_limit": 2
16}

📘 Parameters Explained:

Parameter	Description
album_type	Filter albums by type: album, single, compilation, or any
album_urls	List of album URLs to scrape
include_available_markets	Toggle to include/exclude available markets (default: false)
keywords	List of search terms for discovering albums
maxResults	Max number of albums per keyword (recommended max: 50)
searchMode	Options: keyword, url, or both
track_limit	Limit of tracks to extract per album (max: 100)

---

📤 Output Example

Below is a sample JSON output you’ll receive:

1[
2  {
3    "result_mode": "keyword",
4    "input_keyword": "jazz",
5    "input_url": "keyword input",
6    "album_type": "album",
7    "album_title": "Dave Pike Plays the Jazz Version of Oliver!",
8    "album_artists": [
9      "Dave Pike"
10    ],
11    "album_artists_url": [
12      "https://open.spotify.com/artist/64Qwp26Lb2beXJzBs0qBpl"
13    ],
14    "album_cover": "https://i.scdn.co/image/ab67616d0000b2734b16473a86c98da6f9ce5398",
15    "album_release_date": "2025-04-04",
16    "total_tracks": 7,
17    "total_duration_for_requested_tracks": "10m 40s",
18    "available_markets": "AR, AU, AT, BE, BO, BR, BG, CA, ...",
19    "restrictions": "No Restrictions",
20    "album_url": "https://open.spotify.com/album/0YLWr1T1iCuRm6SnmYibkc",
21    "tracks": [
22      {
23        "track_title": "I'd Do Anything",
24        "track_duration": "4m 53s",
25        "track_artists": [
26          "Dave Pike"
27        ],
28        "tracks_artists_url": [
29          "https://open.spotify.com/artist/64Qwp26Lb2beXJzBs0qBpl"
30        ],
31        "track_url": "https://open.spotify.com/track/02rcL5BYRPBejQm7eelmcx"
32      }
33    ]
34  }
35]

---

📊 Output Field Guide

Field	Description
result_mode	Source of result: keyword or url
input_keyword / input_url	If one is keyword input, the other is marked "keyword input"
album_type	Album type (album, single, compilation)
album_title	Title of the album
album_artists	List of artist names
album_artists_url	Corresponding Spotify artist profile links
album_cover	URL of the album’s cover image
album_release_date	Release date of the album
total_tracks	Total number of tracks on the album
total_duration_for_requested_tracks	Sum duration of extracted tracks
available_markets	List of country codes (optional if enabled)
restrictions	If none, defaults to No Restrictions
album_url	Spotify link to the album
tracks	Array of tracks containing title, artists, URLs, and durations

---

🧪 How It Works

1️⃣ Choose your input method

• Enter keywords like "jazz", "rock", or "pop"
• Or drop in specific album URLs
• Or combine both!

2️⃣ Run the scraper

• The actor searches Spotify and collects detailed album & track info

3️⃣ Download your results

• Get clean JSON data with all fields ready for use

---

📈 Use Cases

🎯 Music Recommendation Systems
📊 Music Market & Genre Analysis
🔍 Research on Albums & Artists
📂 Archiving or Indexing Albums
📱 Mobile or Web Music Apps
📢 Music SEO & Content Generation

---

⚡ Performance & Optimization

✅ High-speed scraping via official Spotify APIs
✅ Up to 50 albums per keyword
✅ Up to 100 tracks per album
✅ Use your own proxy for privacy and control
✅ Toggle market availability data on/off

---

🔐 Privacy & Security

🔒 This scraper respects your data and Spotify access security:

• ✔️ Uses your own proxy setup
• ✔️ Access tokens are fetched dynamically and securely
• ✔️ No hardcoded or exposed credentials

---

📦 Deployment Instructions

1. Deploy the actor on Apify
2. Configure input JSON
3. Run the actor
4. Download clean, structured JSON output

---

🧩 Related Tools

🔗 Spotify Playlists Scraper — Extract full playlist metadata and tracks!
🔗 Spotify Artist Scraper — Get artist info, albums, followers, and more
🔗 Spotify Track Analyzer — Coming soon!

---

📧 Let's Build Together!

Need a custom scraper for Spotify or another platform?
Want to scale your data extraction beyond standard limits?

📩 Contact me: scrapearchitect@gmail.com

---

🎵 Try Spotify Album Scraper Now!

Turn any Spotify album into clean, detailed JSON in seconds.
Whether you're a dev, analyst, blogger, or music tech founder — this tool will supercharge your data game! 🚀💽

👉 Deploy the Spotify Album Scraper and start exploring today! 🎶

---