Pricing

Rating

Developer

Actor stats

Categories

Share

Spotify Scraper — Full Coverage, Pay-Per-Event

Extract any public Spotify data: tracks, artists, albums, playlists, users, podcasts, concerts, charts, lyrics, credits, recommendations, AI insights and more. 40+ categories, accepts Spotify IDs, URLs or search keywords.

Built to undercut canadesk/spotify ($10/mo + usage) and canadesk/spotify-plus ($16/mo + usage):

• $0 monthly rental fee
• $0.20 per 1,000 result items (pay-per-event)
• $0.30 per 1,000 single-entity fetches (bulk-fetch)
• Raw data optional — slim output by default

Features vs. canadesk/spotify

Input

All input fields are documented in the input form.

Categories

Single entities (mode=get): track, track_credits, track_lyrics, album, album_tracks, album_metadata, artist, artist_overview, artist_albums, artist_singles, artist_appears_on, artist_discovered_on, artist_featuring, artist_related, artist_discography_overview, artist_concerts, artist_concert_locations, playlist, playlist_tracks, user_profile, user_followers, recommendations, partner_playlist, partner_track, partner_album, partner_artist_overview, partner_artist_discography.

Search (mode=search): search_multi, search_tracks, search_artists, search_albums, search_playlists, search_users, search_podcasts, search_top_results, search_suggestions, search_lyrics.

Charts (mode=chart): chart_top_200_tracks, chart_viral_tracks, chart_top_artists, chart_top_albums, chart_top_monthly_listeners, chart_top_followers.

Example inputs

Get artist overview from URL

{
"mode":"get",
"category":"artist_overview",
"queries":[
"https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02"
]
}

Search tracks

{
"mode":"search",
"category":"search_tracks",
"queries":[
"bohemian rhapsody",
"taylor swift anti-hero"
],
"maxResultsPerQuery":20,
"market":"US"
}

Top 200 tracks — Mexico

{
"mode":"chart",
"category":"chart_top_200_tracks",
"queries":[
"MX"
],
"chartDate":"2026-04-22"
}

Word-synced lyrics with Spanish translation

{
"mode":"get",
"category":"track_lyrics",
"queries":[
"4iV5W9uYEdYUVa79Axb7Rh"
],
"lyricsLanguage":"es"
}

Output

Each item is a flat JSON object with:

• category — what was scraped
• mode — get / search / chart
• query — original input
• id, type, name, uri, url — normalized entity fields
• plus every field returned by the upstream API
• optional raw — full upstream JSON (includeRaw=true)
• optional contrast — cross-platform data (enrichWithContrast)

Errors are pushed as { ok: false, error, query, category } so partial failures never break the run.

Pricing (pay-per-event)

Example: a run that pushes 10,000 track rows costs $2.00 total. The same run on canadesk/spotify-plus would cost $16/mo rental + their per-result fees.

Environment variables

Set in Apify console → Actor → "Environment" (mark *_KEY vars as secret):

• SPOTIFY_BYPASS_KEY — preferred. Internal bypass key for the self-hosted proxy. No quotas, no RapidAPI fees.
• RAPIDAPI_KEY — fallback: a key issued via RapidAPI if bypass is unavailable.
• RAPIDAPI_HOST — only needed with RAPIDAPI_KEY.
• SPOTIFY_API_BASE — override upstream. Default: https://spotify-proxy.checkleaked.cc/spotify-data.
• SPOTIFY_TIMEOUT_MS — request timeout (default 90s).
• SPOTIFY_MAX_RETRIES — retries on 429/5xx (default 3).

Auth priority: SPOTIFY_BYPASS_KEY > RAPIDAPI_KEY. Neither set → upstream returns 401.

Local development

npminstall
npm run build
apify run

Edit storage/key_value_stores/default/INPUT.json to change input between runs.

License

MIT