🎵 Spotify Music & MP3 Downloader

Fast, reliable, and metadata-rich Spotify audio downloader on Apify. Batch extract audio streams, album covers, and complete track metadata from any public Spotify track, playlist, or album link.

---

📋 Overview

Need to archive music, build playlists, extract preview clips, or integrate music streaming data into your workflow? Spotify Music & MP3 Downloader delivers everything in one clean JSON record:

• 🎧 Direct Audio Links: Instant CDN download URLs in AAC (.m4a) and Opus (.webm) audio formats.
• 🎼 Single-Click Download: Top-level audio_download_url for effortless downstream automation.
• 📻 Spotify 30s Audio Preview: Direct MP3 preview clip stream straight from Spotify CDN.
• 📦 Batch Playlist & Album Support: Enter full playlists or albums; the actor automatically expands and processes every track.
• 📝 Rich Metadata: Song title, artist names with Spotify URIs, album name, release date, explicit flag, duration in seconds, and timestamps.
• 🖼️ Full HD Artwork: 640x640 high-resolution album cover thumbnails.
• 💰 Fair Pay-Per-Event Pricing: Pay only for successful track downloads with a generous free trial.

---

💎 Pricing & Pay-Per-Event (PPE)

This actor operates on a transparent Pay-Per-Event billing model:

Plan / Event	Cost	Details
Event: spotify-track	$0.005 / track	Charged per successfully scraped & resolved audio track
Free Trial	Free (3 tracks)	Unpaid Apify users can test up to 3 tracks per run
Paid Subscribers	Unlimited	Unlimited track and playlist extraction with per-event charging

No expensive compute unit (CU) waste — lightweight, fast, and cost-effective.

---

✨ Core Features

🎧 Audio Stream Extraction

• Multiple Formats: Direct links for both M4A (AAC) and WebM (Opus).
• Exact Bitrates: Audio bitrate reported in kbps.
• Top-Level Download URL: Convenient audio_download_url pointing directly to the highest-compatibility AAC stream.
• Official 30s Preview: Direct link to Spotify's official 30-second MP3 preview.

📚 Comprehensive Metadata

• Track & Artist Details: Song title, primary track name, formatted artist names, and detailed artist arrays with Spotify URIs.
• Album & Release Details: Album name, exact ISO release date (YYYY-MM-DD), and explicit content tag (true/false).
• High-Res Visuals: Up to 640x640 album artwork.
• Playlist Position Tracking: Original playlist/source URL, track_index, and total_tracks.

---

⚙️ Input Configuration

Paste any public Spotify track, playlist, or album URL into the spotify_urls list:

{
  "spotify_urls": [
    {
      "url": "https://open.spotify.com/track/18Rn3LSsOlsPKdYL0DzomL"
    },
    {
      "url": "https://open.spotify.com/playlist/37i9dQZF1E4mFcb8TyZl7v"
    }
  ]
}

📝 Input Fields

Parameter	Type	Required	Description
spotify_urls	Array of Objects	Yes	List of Spotify track, playlist, or album URLs
url	String	Yes	Valid Spotify URL (e.g. https://open.spotify.com/track/... or https://open.spotify.com/playlist/...)
max_concurrency	Integer	No	Parallel worker count (default: 6, min: 1, max: 15). Accelerates playlist and album extraction by up to 6x–8x.
proxy	Object	No	Proxy configuration (defaults to Apify US Residential Proxy).

---

📤 Output Structure

Every processed track produces a comprehensive JSON record in your Apify dataset:

{
  "spotify_url": "https://open.spotify.com/track/18Rn3LSsOlsPKdYL0DzomL",
  "title": "Din Gelo - Habib Wahid",
  "track_name": "Din Gelo",
  "artist_name": "Habib Wahid",
  "album_name": "Panjabiwala",
  "release_date": "2008-01-01",
  "explicit": false,
  "duration": "5m 40s",
  "duration_sec": 340.1,
  "thumbnail": "https://image-cdn-fa.spotifycdn.com/image/ab67616d0000b27375ab73fa7da733762d2cb5a3",
  "preview_url": "https://p.scdn.co/mp3-preview/...",
  "audio_download_url": "https://rr5---sn-u1hp55-5c.googlevideo.com/videoplayback?...",
  "youtube_url": "https://www.youtube.com/watch?v=S7DxwCNw3y4",
  "artists": [
    {
      "name": "Habib Wahid",
      "uri": "spotify:artist:60jYUgQzKAtnJoXKGk1GNn"
    }
  ],
  "audio_formats": [
    {
      "audio_link": "https://rr5---sn-u1hp55-5c.googlevideo.com/videoplayback?...",
      "audio_format": "m4a",
      "audio_bitrate": 48.8,
      "explanation": "Audio format: m4a, Bitrate: 48.8 kbps"
    },
    {
      "audio_link": "https://rr5---sn-u1hp55-5c.googlevideo.com/videoplayback?...",
      "audio_format": "webm",
      "audio_bitrate": 53.8,
      "explanation": "Audio format: webm, Bitrate: 53.8 kbps"
    }
  ],
  "source_url": "https://open.spotify.com/playlist/37i9dQZF1E4mFcb8TyZl7v",
  "source_type": "playlist",
  "track_index": 1,
  "total_tracks": 50,
  "type": "single",
  "error": false,
  "scraped_at": "2026-10-25T13:20:04.123456Z"
}

📊 Output Field Reference

Field	Type	Description
spotify_url	String	Direct canonical Spotify URL for the track
title	String	Full title formatted as Song Name - Artist
track_name	String	Clean track title
artist_name	String	Comma-separated list of performing artists
album_name	String	Album title
release_date	String	Album / track release date (ISO format YYYY-MM-DD)
explicit	Boolean	true if content is flagged explicit, else false
duration	String	Formatted duration (e.g. 5m 40s)
duration_sec	Number	Exact duration in seconds
thumbnail	String	High-resolution 640x640 album cover artwork
preview_url	String	Official Spotify 30-second MP3 preview clip stream URL
audio_download_url	String	Primary high-speed direct audio stream download URL
youtube_url	String	Matched audio source URL
artists	Array	Full artist list with individual names and Spotify URIs
audio_formats	Array	Detailed audio streams with format and bitrate info
source_url	String	Input playlist/album/track URL
source_type	String	Source origin (single, playlist, album)
track_index	Number	Track index in the batch
total_tracks	Number	Total tracks in the batch
scraped_at	String	ISO 8601 scraping timestamp

---

🎚️ Audio Codecs & Compatibility

1. M4A (AAC Codec): Compatible natively with iOS, macOS, Windows, Android, and web browsers.
2. WebM (Opus Codec): Next-gen audio codec offering superior acoustic clarity at compact file sizes.
3. Official Preview (MP3): 30-second official snippet suitable for ringtones, UI snippets, and audio fingerprints.

---

🛡️ Best Practices & Notes

• Private & Region-Locked Tracks: Only publicly discoverable Spotify tracks can be fetched.
• Direct Link Validity: YouTube CDN streaming URLs contain security tokens that expire after several hours. If you need long-term storage, download the audio file directly to your S3 bucket or local drive upon extraction.
• Large Playlists: For playlists exceeding 100 tracks, consider splitting across multiple runs or configuring appropriate timeout settings.

---

💬 Support & Customization

Need custom audio extraction, higher bitrates, ID3 tag injection, or webhook integrations? Contact us at: codenest2.0@gmail.com