---

Spotify Search & Complete Data Scraper ✨

---

The most powerful Spotify Search tool and Spotify Scraper on Apify. Search any keyword across every Spotify category — or paste URIs/URLs to fetch complete metadata for any track, album, artist, playlist, genre, audiobook, podcast, or episode. This Spotify Scraper extracts everything Spotify has: full track details, album track lists, artist overviews, playlist contents, genre/mood browsing, audiobook chapters, podcast episodes, and more — all without needing a Spotify account or premium subscription.

Why This Spotify Search & Spotify Scraper?

Most Spotify scrapers only handle one data type or break when Spotify updates its platform. This Spotify Search and Spotify Scraper supports 9 different data categories across 2 powerful modes, with automatic retry logic, residential proxy support for 55+ countries, and clean flat JSON output ready for analysis.

Feature	This Spotify Scraper	Other Spotify Scrapers
Search across 9 categories	✅ Tracks, Albums, Artists, Playlists, Genres, Users, Audiobooks, Episodes, Podcasts	⚠️ 1–3 types at best
Full detail fetching by URI/URL	✅ Paste any Spotify URI or URL	❌ Search-only or limited
Combined Search + Detail mode	✅ Auto-fetch details for every search result	❌ Not available
Playlist & album track lists	✅ Full paginated track lists	⚠️ First page only
Genre/Mood browsing with sections	✅ Complete section data with item details	❌ Not supported
Audiobook chapter lists	✅ Full chapter pagination	❌ Not supported
Podcast episode lists	✅ Full episode pagination	❌ Not supported
Artist overview (bio, stats, discography)	✅ Complete overview data	⚠️ Basic info only
55+ proxy countries	✅ US, GB, AU, CA + 51 more	⚠️ No proxy or limited
No browser required	✅ Pure HTTP (fast & cheap)	❌ Most use Puppeteer
Automatic retry on empty results	✅ Built-in retry logic	❌ Fails silently
Clean flat JSON output	✅ Ready for analysis	⚠️ Nested/raw API dumps

This Spotify Search actor and Spotify Scraper delivers more Spotify data at a fraction of the cost compared to every alternative.

---

✨ Key Features

🔍 Spotify Search — Search Mode Features

• Spotify Search across 9 categories: Tracks, Albums, Artists, Playlists, Genres/Moods, Users/Profiles, Audiobooks, Full Episodes, Podcasts/Shows
• Customizable result limits, offsets, and top-results count per search type
• Optional Fetch Full Details toggle — automatically runs the matching detail scraper on every search result
• Keyword-based Spotify Search (supports multiple keywords per run) returns ranked results just like the Spotify app

🔗 Spotify Scraper — Get Details Mode Features

• Paste one or more Spotify URIs or open.spotify.com URLs
• This Spotify Scraper fetches complete metadata for each entity:
  • 🎵 Tracks: Full track metadata, artists, album info, duration, popularity, preview URLs
  • 💿 Albums: Album metadata + paginated track list with offset/limit control
  • 🎤 Artists: Complete artist overview — bio, stats, top tracks, discography, related artists, playlists
  • 🎧 Playlists: Playlist metadata + paginated track list with offset/limit control
  • 🎨 Genres/Moods: Genre/mood page browsing with section navigation and item details
  • 📚 Audiobooks: Metadata + chapter list + optional similar audiobook recommendations
  • 🎙️ Full Episodes: Episode metadata + optional recommended episodes
  • 🎙 Podcasts/Shows: Show metadata + paginated episode list + optional recommended shows

🌐 Proxy & Regional Support

• 55+ residential proxy countries — Spotify sees requests from your chosen location
• ⭐ US recommended — widest catalog, only country guaranteed for ALL scraper types
• Regional restrictions handled automatically:
  • Podcasts & Episodes → US, GB, AU, or CA
  • Audiobooks → US, GB, AU, CA only
  • Music (Tracks/Albums/Artists) → works in most countries

---

🎯 Two Powerful Modes

Mode 1: 🔍 Search Mode — Spotify Search by Keyword(s)

Enter one or more keywords and select a search type. This Spotify Search mode sends each keyword to Spotify and returns ranked results. You can add multiple keywords — each one runs as a separate search in a single actor run. Available search types:

Search Type	What This Spotify Search Returns
🎵 Tracks / Songs	Track name, artist(s), album, duration, popularity, URI, preview URL
💿 Albums	Album name, artist(s), release date, total tracks, cover art, URI
🎤 Artists	Artist name, genres, follower count, popularity, image, URI
🎧 Playlists	Playlist name, owner, description, track count, cover image, URI
🎨 Genres / Moods	Genre pages, mood categories with playlists and curated content
👤 Users / Profiles	Username, display name, follower count, image, profile URI
📚 Audiobooks	Title, author(s), narrator(s), publisher, description, chapter count, URI
🎙️ Full Episodes	Episode title, show name, description, duration, release date, URI
🎙 Podcasts / Shows	Show name, publisher, description, total episodes, URI

Fetch Full Details — Every search type (except Users) has a toggle to automatically run the matching detail Spotify Scraper on every result URI. Turn it ON to get complete metadata merged into each search result.

Mode 2: 🔗 Get Details Mode — Spotify Scraper by URI/URL

Paste one or more Spotify URIs or URLs, select the entity type, and this Spotify Scraper fetches complete metadata for each item. The detail scraper runs automatically — no extra toggle needed.

Get Details Type	What This Spotify Scraper Returns
🎵 Track	Complete track metadata — artists, album, duration, popularity, preview URL, disc/track number
💿 Album	Full album metadata + paginated track list (control offset & limit)
🎤 Artist	Complete artist overview — biography, stats, top tracks, albums, singles, compilations, related artists, playlists, merch
🎧 Playlist	Full playlist metadata + paginated track list (control offset & limit)
🎨 Genre / Mood	Genre page with sections — each section contains curated playlists and content
📚 Audiobook	Metadata + chapter list (paginated) + optional similar audiobooks
🎙️ Full Episode	Episode details + optional recommended episodes
🎙 Podcast / Show	Show metadata + episode list (paginated) + optional recommended shows

---

🔗 Supported Spotify URL & URI Formats

This Spotify Search and Spotify Scraper accepts all standard Spotify identifiers. You can paste any of these formats in Get Details Mode:

Spotify URI Format

Entity	URI Format	Example
Track	spotify:track:ID	spotify:track:0VjIjW4GlUZAMYd2vXMi3b
Album	spotify:album:ID	spotify:album:1DFixLWuPkv3KT3TnV35m3
Artist	spotify:artist:ID	spotify:artist:06HL4z0CvFAxyc27GXpf02
Playlist	spotify:playlist:ID	spotify:playlist:37i9dQZF1DXcBWIGoYBM5M
Genre / Mood	spotify:genre:ID or spotify:page:ID	spotify:genre:0JQ5DAqbMKFEC4WFtoNRpw
Audiobook	spotify:show:ID (select 📚 Audiobook)	spotify:show:5CfCWKI5pZ28U0uOzXkDHe
Episode	spotify:episode:ID	spotify:episode:512ojhOuo1ktJprKbVcKyQ
Podcast / Show	spotify:show:ID (select 🎙 Podcast)	spotify:show:4rOoJ6Egrf8K2IrywzwOMk

open.spotify.com URL Format

Entity	URL Format
Track	https://open.spotify.com/track/ID
Album	https://open.spotify.com/album/ID
Artist	https://open.spotify.com/artist/ID
Playlist	https://open.spotify.com/playlist/ID
Genre / Mood	https://open.spotify.com/genre/ID
Episode	https://open.spotify.com/episode/ID
Podcast / Show	https://open.spotify.com/show/ID

💡 Tip: For spotify:show: URIs, both Audiobooks and Podcasts share the same prefix. Select the correct type (📚 Audiobook or 🎙 Podcast/Show) in the Get Details Type dropdown so the right Spotify Scraper runs.

---

📊 Filters & Fields — Complete Reference per Scraper Type

Every scraper type in this Spotify Search and Spotify Scraper has its own set of configurable filters. Here's what each field does:

🎵 Tracks / Songs

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for search pagination (0 = first page)	0
Search Limit	🔍 Search	Maximum number of track results to return	10
Top Results Count	🔍 Search	Number of top-ranked items highlighted	10
Fetch Full Track Details	🔍 Search	ON = runs detail Spotify Scraper on every search result URI	OFF

Get Details Mode: No additional filters — the track detail Spotify Scraper returns complete metadata automatically.

---

💿 Albums

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for search pagination	0
Search Limit	🔍 Search	Maximum album results to return	30
Top Results Count	🔍 Search	Top-ranked items highlighted	20
Get: Track List Offset	🔗 Get Details / 🔍 with Fetch Details ON	Starting position in the album's track list	0
Get: Track List Limit	🔗 Get Details / 🔍 with Fetch Details ON	Maximum tracks from the album	50
Fetch Full Album Details	🔍 Search	ON = runs detail Spotify Scraper on every result, activates track list filters	OFF

---

🎤 Artists

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for Spotify Search pagination	0
Search Limit	🔍 Search	Maximum artist results to return	30
Top Results Count	🔍 Search	Top-ranked items highlighted	20
Fetch Full Artist Details	🔍 Search	ON = runs detail Spotify Scraper on every result URI	OFF

Get Details Mode: No additional filters — the artist overview Spotify Scraper returns complete bio, stats, top tracks, discography, related artists, and playlists automatically.

---

🎧 Playlists

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for Spotify Search pagination	0
Search Limit	🔍 Search	Maximum playlist results to return	30
Top Results Count	🔍 Search	Top-ranked items highlighted	20
Get: Track List Offset	🔗 Get Details / 🔍 with Fetch Details ON	Starting position in the playlist's track list	0
Get: Track List Limit	🔗 Get Details / 🔍 with Fetch Details ON	Maximum tracks from the playlist	25
Fetch Full Playlist Details	🔍 Search	ON = runs detail Spotify Scraper, activates track list filters	OFF

---

🎨 Genres / Moods

The Genre Spotify Scraper uses two operations: browsePage (page overview with section previews) and browseSection (full item list per section).

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for Spotify Search pagination	0
Search Limit	🔍 Search	Maximum genre results to return	30
Top Results Count	🔍 Search	Top-ranked items highlighted	20
Get: How Many Sections	🔗 Get Details / 🔍 with Fetch Details ON	Number of sections to fetch from the genre page	10
Get: Items Per Section	🔗 when Include Section Details is ON	Max items per section (only active with section details)	20
Include Section Details	🔗 Get Details / 🔍 with Fetch Details ON	ON = full items per section; OFF = quick 10-item preview (faster)	OFF
Fetch Full Genre Details	🔍 Search	ON = runs genre Spotify Scraper on every result, activates all Get filters	OFF

---

👤 Users / Profiles

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for Spotify Search	0
Search Limit	🔍 Search	Maximum user results to return	30
Top Results Count	🔍 Search	Top-ranked items highlighted	20

⚠️ Users are Search Mode only — Get Details Mode is not available for Users. Spotify Search returns full public profile data directly.

---

📚 Audiobooks

Availability: US, GB, AU, CA proxy countries only.

The Audiobook Spotify Scraper runs up to 3 operations:

1. Main metadata — always runs
2. Chapter list — always runs (paginated with offset/limit)
3. Similar audiobooks — controlled by the Include Similar toggle

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for Spotify Search	0
Search Limit	🔍 Search	Maximum audiobook results	30
Top Results Count	🔍 Search	Top-ranked items highlighted	20
Get: Chapter List Offset	🔗 Get Details / 🔍 with Fetch Details ON	Starting position in the chapter list	0
Get: Chapter List Limit	🔗 Get Details / 🔍 with Fetch Details ON	Maximum chapters to fetch per audiobook	50
Include Similar Audiobooks	🔗 Get Details / 🔍 with Fetch Details ON	ON = fetch similar recommendations; OFF = skip (faster)	OFF
Fetch Full Audiobook Details	🔍 Search	ON = runs all 3 operations on every search result, activates all Get filters	OFF

---

🎙️ Full Episodes

The Episode Spotify Scraper runs up to 2 operations:

1. Episode metadata — always runs
2. Recommended episodes — controlled by the Include Recommended toggle

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for Spotify Search	0
Search Limit	🔍 Search	Maximum episode results	30
Include Recommended Episodes	🔗 Get Details / 🔍 with Fetch Details ON	ON = fetch related episode recommendations; OFF = skip (faster)	OFF
Fetch Full Episode Details	🔍 Search	ON = runs the episode Spotify Scraper on every result, activates the toggle above	OFF

---

🎙 Podcasts / Shows

Recommended proxies: US, GB, AU, CA.

The Podcast Spotify Scraper runs up to 3 operations:

1. Show metadata — always runs
2. Episode list — always runs (paginated with offset/limit)
3. Recommended shows — controlled by the Include Recommended toggle

Field	Mode	Description	Default
Search Offset	🔍 Search	Starting position for Spotify Search pagination	0
Search Limit	🔍 Search	Maximum podcast results	30
Get: Episode List Offset	🔗 Get Details / 🔍 with Fetch Details ON	Starting position in the episode list	0
Get: Episode List Limit	🔗 Get Details / 🔍 with Fetch Details ON	Maximum episodes per podcast	50
Include Recommended Shows	🔗 Get Details / 🔍 with Fetch Details ON	ON = fetch recommended shows; OFF = skip (faster)	OFF
Fetch Full Podcast Details	🔍 Search	ON = runs all 3 operations, activates all Get filters	OFF

---

🚀 Quick Start Examples

Example 1: Spotify Search for Tracks

{
  "mode": "search",
  "searchType": "searchTracks",
  "keyword": ["Blinding Lights"],
  "tracks_search_limit": 10,
  "proxyCountry": "US"
}

This Spotify Search returns up to 10 track results for "Blinding Lights".

Example 2: Spotify Scraper — Get Full Album Details

{
  "mode": "get_details",
  "getDetailsType": "album",
  "spotifyUris": ["spotify:album:4yP0hdKOZPNshxUOjY0cZj"],
  "albums_get_limit": 100,
  "proxyCountry": "US"
}

This Spotify Scraper fetches complete album metadata plus up to 100 tracks from the album's track list.

Example 3: Spotify Search + Auto-Fetch Artist Details

{
  "mode": "search",
  "searchType": "searchArtists",
  "keyword": ["The Weeknd"],
  "artists_search_limit": 5,
  "artists_fetchDetails": true,
  "proxyCountry": "US"
}

This Spotify Search finds up to 5 artists, then the Spotify Scraper automatically fetches complete artist overviews for each result.

Example 4: Spotify Scraper — Get Podcast Episodes

{
  "mode": "get_details",
  "getDetailsType": "podcast",
  "spotifyUris": ["spotify:show:4rOoJ6Egrf8K2IrywzwOMk"],
  "podcasts_get_limit": 20,
  "podcasts_includeRecommended": true,
  "proxyCountry": "US"
}

This Spotify Scraper fetches podcast metadata, up to 20 episodes, and recommended similar shows.

Example 5: Spotify Search for Genres + Section Details

{
  "mode": "search",
  "searchType": "searchGenres",
  "keyword": ["chill"],
  "genres_search_limit": 5,
  "genres_fetchDetails": true,
  "genres_includeSectionDetails": true,
  "genres_get_sectionLimit": 5,
  "genres_get_sectionItemLimit": 15,
  "proxyCountry": "US"
}

This Spotify Search finds up to 5 genre pages, then the Spotify Scraper browses each page fetching 5 sections with up to 15 items per section.

Example 6: Spotify Scraper — Multiple Tracks by URL

{
  "mode": "get_details",
  "getDetailsType": "track",
  "spotifyUris": [
    "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
    "spotify:track:7qiZfU4dY1lWllzX7mPBI3"
  ],
  "proxyCountry": "US"
}

This Spotify Scraper accepts both URL and URI formats — mix and match freely.

---

📋 How the Fetch Details Toggle Works

Each search type (except Users) has a Fetch Full Details toggle:

Setting	In Search Mode	In Get Details Mode
Fetch Full Details = ON	✅ Runs the detail Spotify Scraper on every search result URI	Ignored — detail scraper always runs
Fetch Full Details = OFF	❌ Returns search results only (faster)	Ignored — detail scraper always runs

Toggle buttons (Include Section Details, Include Similar, Include Recommended):

• ✅ Your ON/OFF choice is respected in both modes
• Control optional operations (extra API calls)

Pagination filters (Track List Offset/Limit, Chapter Offset/Limit, etc.):

• 🔗 Always active in Get Details Mode
• 🔍 Only active in Search Mode when Fetch Full Details is ON

---

🌐 Proxy Country Guide

This Spotify Search and Spotify Scraper supports 55+ residential proxy countries:

Region	Countries	Supported Types
⭐ Full Support	US, GB, AU, CA	ALL types — Tracks, Albums, Artists, Playlists, Genres, Audiobooks, Podcasts, Episodes
✅ Europe	DE, FR, NL, IT, ES, SE, NO, DK, FI, BE, AT, CH, IE, PL, PT, CZ, HU, RO, GR, BG, HR, SK, RS	Music & Artists
🌏 Asia-Pacific	JP, KR, SG, HK, TW, TH, MY, ID, PH, VN, IN	Music only
🌎 Americas	BR, MX, AR, CL, CO, PE	Music catalog only
🌍 Middle East & Africa	ZA, NG, KE, EG, SA, AE, TR, IL	Music only
🌐 Other	UA, RU, BY	Music only

💡 If results are empty, switch to US. This Spotify Scraper works best with a US proxy due to Spotify's widest catalog availability.

---

📦 Output Format

This Spotify Search and Spotify Scraper outputs clean, flat JSON objects to the Apify dataset. Each result includes:

• scraper_type — which Spotify Search or Spotify Scraper type was used
• keyword (Search Mode) or uri (Get Details Mode) — the input that produced this result
• variables — the filter values that were applied
• result — the complete Spotify data object

All output is structured, deduplicated, and ready for direct analysis, export, or integration.

---

🔒 Privacy & Security

This Spotify Scraper is designed with security in mind:

• ✅ No credentials, API keys, or tokens are stored or exposed in output
• ✅ All authentication is handled internally and securely
• ✅ Logs are sanitized — no sensitive data appears in run logs
• ✅ Residential proxy traffic is encrypted

---

❓ FAQ

Q: Do I need a Spotify account to use this Spotify Scraper? A: No. This Spotify Scraper works without any Spotify account or API credentials.

Q: Can I search and get details in the same run? A: Yes! In Search Mode, turn on the Fetch Full Details toggle. The Spotify Search finds results, then the Spotify Scraper automatically fetches complete details for each result.

Q: Why are my results empty? A: Try switching the proxy country to US. This Spotify Scraper has the widest compatibility with US proxies. Some types (Audiobooks, Podcasts, Episodes) are region-restricted.

Q: Can I paste both URIs and URLs? A: Yes. This Spotify Scraper accepts both spotify:track:ID format and https://open.spotify.com/track/ID format. Mix and match freely.

Q: How many URIs can I process at once? A: There is no hard limit. Paste as many URIs as you need — this Spotify Scraper processes each one sequentially with automatic retry logic.

Q: Why does the Audiobook/Podcast scraper need type selection? A: Both Audiobooks and Podcasts use spotify:show: URIs. Select the correct type (📚 Audiobook or 🎙 Podcast/Show) so the right Spotify Scraper operations run.