# Spotify Scraper — Artists, Tracks & Playlists (`khadinakbar/spotify-all-in-one-scraper`) Actor Scrape Spotify artists, albums, tracks, playlists, podcasts, episodes, and search with play counts and monthly listeners. HTTP-only, no API key. - **URL**: https://apify.com/khadinakbar/spotify-all-in-one-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Social media, MCP servers, Developer tools - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 result scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Spotify Scraper — Artists, Tracks & Playlists ### What does Spotify Scraper do? **Spotify Scraper** extracts structured data from [Spotify](https://open.spotify.com) for **every entity type in a single Actor** — artists, albums, tracks, playlists, podcast shows, episodes, and keyword search. Paste any Spotify URL, URI, or ID and it auto-detects what to scrape. Unlike Spotify's official Web API, it returns the data the music industry actually cares about: **exact play counts, monthly listeners, follower counts, world rank, and top listener cities** — pulled from Spotify's internal Partner API, with a stable fallback for guaranteed coverage. No Spotify developer account, app registration, or API key is required. Running on the Apify platform you also get API access, scheduling, webhooks, integrations (Make, Zapier, Google Sheets), residential proxy rotation, and run monitoring out of the box. ### Why use Spotify Scraper? - **Music analytics & A&R** — track monthly listeners, world rank, and per-track play counts to spot breakout artists. - **Playlist research** — pull full track listings, follower counts, and owners for editorial and user playlists. - **Label & artist monitoring** — watch follower growth, top cities, discography, and new releases over time with scheduled runs. - **Podcast intelligence** — scrape shows, publishers, ratings, topics, and complete episode listings. - **AI agents & apps** — clean, flat JSON makes this an ideal tool call for LLM agents building music discovery or recommendation features. The Actor is MCP-ready. ### How to use Spotify Scraper 1. Click **Try for free**. 2. Paste one or more Spotify URLs/URIs/IDs into **Spotify URLs**, and/or type keywords into **Search queries**. 3. (Optional) Set **Max results** to cap cost, and choose **Concise** or **Detailed** output. 4. Click **Start**. Download results as JSON, CSV, Excel, or HTML, or pull them via the Apify API. The Actor figures out the entity type from each link automatically, so you can mix artists, albums, playlists, and podcasts in one run. ### Input | Field | Description | |-------|-------------| | **Spotify URLs** | URLs, URIs, or 22-char IDs. Type auto-detected (artist/album/track/playlist/show/episode). | | **Search queries** | Free-text keywords; returns top results of every type. | | **Default type for bare IDs** | Type assumed for bare IDs with no URL context. | | **Search results per type** | How many results per type for keyword search (1–50). | | **Max results** | Hard cap on total billed results. | | **Response format** | `concise` (first 50 nested items) or `detailed` (all, up to 1000). | | **Proxy configuration** | Residential proxy, enabled by default (required by Spotify). | #### Input example ```json { "spotifyUrls": [ "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4", "spotify:album:4yP0hdKOZPNshxUOjY0cZj" ], "searchQueries": ["lo-fi beats"], "maxResults": 50, "responseFormat": "concise" } ```` ### Output Each result is one flat JSON record. You can download the dataset in JSON, CSV, Excel, HTML, or XML. Example artist record (trimmed): ```json { "type": "artist", "id": "3TVXtAsR1Inumwj472S9r4", "uri": "spotify:artist:3TVXtAsR1Inumwj472S9r4", "url": "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4", "name": "Drake", "verified": true, "monthlyListeners": 98722254, "followers": 111849680, "worldRank": 9, "topCities": [{ "city": "London", "country": "GB", "listeners": 2284030 }], "biography": "Canadian rapper and vocalist Drake...", "topTracks": [{ "name": "One Dance", "playcount": 2900000000, "durationMs": 173986 }], "discography": { "albumCount": 21, "singleCount": 62, "latest": { "name": "ICEMAN" } }, "popularityDataAvailable": true, "dataSource": "partner", "scrapedAt": "2026-05-30T18:20:00.000Z" } ``` #### Data table | Field | Appears on | Description | |-------|-----------|-------------| | `type` | all | artist, album, track, playlist, show, episode | | `name` | all | Entity name | | `uri` / `url` | all | Spotify URI and open.spotify.com link | | `monthlyListeners` | artist | Current monthly listeners | | `followers` | artist, playlist | Follower / save count | | `worldRank` | artist | Global popularity rank | | `topCities` | artist | Top listener cities with counts | | `biography` | artist | Artist bio text | | `playcount` | track, album tracks | Exact stream count | | `durationMs` | track, episode | Duration in milliseconds | | `label` / `copyrights` | album | Record label and copyright lines | | `tracks` | album, playlist | Track listing with play counts | | `publisher` / `rating` | show | Podcast publisher and average rating | | `totalEpisodes` / `episodes` | show | Episode count and listing | | `dataSource` | all | `partner` (rich) or `embed` (baseline fallback) | ### How much does it cost to scrape Spotify? This Actor uses **pay-per-result** pricing: **$0.005 per result** plus a tiny **$0.00005 start fee**. One result = one entity (artist, album, track, playlist, show, or episode) or one keyword-search item. A run scraping 50 artists costs about **$0.25**. Full track and episode listings are included free inside each entity record — a 500-track playlist still counts as a single $0.005 result. New Apify accounts include free monthly usage credits to get started. ### Tips & advanced options - Use **Max results** to keep cost predictable on large search runs. - Use **Detailed** format when you need every track of a long playlist or every episode of a podcast. - Mix artists, albums, playlists, and podcasts in one run — types are auto-detected. - Schedule runs to monitor follower and play-count growth over time. - Records include a `dataSource` field so you always know whether popularity data was available (`partner`) or only baseline metadata (`embed`). ### FAQ, disclaimers, and support **Do I need a Spotify account or API key?** No. The Actor works entirely from Spotify's public web player. **Is scraping Spotify legal?** This Actor collects only publicly available data and is intended for legitimate research, analytics, and content workflows. You are responsible for complying with Spotify's Terms of Service and applicable laws in your jurisdiction, and for how you use the data. It does not download or distribute audio. **Why are some podcast/episode records lighter than music records?** When Spotify's Partner API is briefly unavailable, the Actor falls back to baseline metadata from the public embed page and sets `popularityDataAvailable: false`, so a run never fails silently. **Found a bug or need a field added?** Open an issue on the Actor's **Issues** tab. Custom requirements and bespoke scraping solutions are welcome. ### Related actors - [YouTube Transcript Extractor](https://apify.com/khadinakbar/youtube-transcript-extractor) — full transcripts for music videos and podcast episodes you find on Spotify. - [YouTube Shorts Scraper](https://apify.com/khadinakbar/youtube-shorts-scraper) — short-form video coverage for the artists you track on Spotify. - [Instagram Reels Scraper](https://apify.com/khadinakbar/instagram-reels-scraper) — Reels engagement data for artists' Instagram presence. - [TikTok Trending Hashtags Scraper](https://apify.com/khadinakbar/tiktok-trending-hashtags-scraper) — surface trending songs and artists on TikTok. - [Telegram Channel Scraper](https://apify.com/khadinakbar/telegram-channel-scraper) — fan-channel intelligence for artists with active Telegram communities. # Actor input Schema ## `spotifyUrls` (type: `array`): Spotify references to scrape. Accepts full URLs (https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4), URIs (spotify:album:4yP0hdKOZPNshxUOjY0cZj), or bare 22-character IDs. The entity type (artist, album, track, playlist, show, episode) is auto-detected from the URL/URI. For a bare ID, the type set in 'Default type for bare IDs' is used. This is NOT a keyword search box — put search terms in 'Search queries' instead. ## `searchQueries` (type: `array`): Free-text keywords to search across Spotify (e.g. 'arctic monkeys' or 'true crime podcast'). Each query returns the top results of every type — artists, albums, tracks, playlists, shows, and episodes. Use 'Results per type' to control how many of each. Leave empty if you only want to scrape specific URLs. ## `defaultType` (type: `string`): Entity type assumed when an input is a bare 22-character Spotify ID with no URL/URI context. Ignored for full URLs and URIs (those carry their own type). Defaults to 'artist'. ## `searchResultsPerType` (type: `integer`): For keyword searches, how many results to return per result type (artists, albums, tracks, playlists, shows, episodes). For example, 5 returns up to 5 artists + 5 albums + 5 tracks, and so on. Range 1-50. Defaults to 5. Does not affect direct URL scraping. ## `maxResults` (type: `integer`): Hard cap on the total number of result records produced (and billed) across the whole run. Each scraped entity or search-result item counts as one result. Use it to control cost. Defaults to 50. ## `responseFormat` (type: `string`): 'concise' returns the core record with the first ~50 nested items (album tracks, playlist tracks, show episodes) — ideal for AI agents and quick scans. 'detailed' paginates and includes all nested items up to 1000. Billing is identical (one charge per entity); 'detailed' only adds run time. Defaults to 'concise'. ## `proxyConfiguration` (type: `object`): Proxy used for all requests. Spotify blocks datacenter IPs at its edge, so Apify Residential proxy is strongly recommended and enabled by default. Leave as-is unless you have a specific reason to change it. ## Actor input object example ```json { "spotifyUrls": [ "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4", "https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj", "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "https://open.spotify.com/show/2MAi0BvDc6GTFvKFPXnkCL" ], "searchQueries": [ "arctic monkeys" ], "defaultType": "artist", "searchResultsPerType": 5, "maxResults": 50, "responseFormat": "concise", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "spotifyUrls": [ "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4", "https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj", "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "https://open.spotify.com/show/2MAi0BvDc6GTFvKFPXnkCL" ], "searchQueries": [ "arctic monkeys" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/spotify-all-in-one-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "spotifyUrls": [ "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4", "https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj", "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "https://open.spotify.com/show/2MAi0BvDc6GTFvKFPXnkCL", ], "searchQueries": ["arctic monkeys"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/spotify-all-in-one-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "spotifyUrls": [ "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4", "https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj", "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "https://open.spotify.com/show/2MAi0BvDc6GTFvKFPXnkCL" ], "searchQueries": [ "arctic monkeys" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call khadinakbar/spotify-all-in-one-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/spotify-all-in-one-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spotify Scraper — Artists, Tracks & Playlists", "description": "Scrape Spotify artists, albums, tracks, playlists, podcasts, episodes, and search with play counts and monthly listeners. HTTP-only, no API key.", "version": "0.1", "x-build-id": "TOU3MXoDKgfnNV4NR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~spotify-all-in-one-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-spotify-all-in-one-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~spotify-all-in-one-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-spotify-all-in-one-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~spotify-all-in-one-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-spotify-all-in-one-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "spotifyUrls": { "title": "Spotify URLs, URIs, or IDs", "type": "array", "description": "Spotify references to scrape. Accepts full URLs (https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4), URIs (spotify:album:4yP0hdKOZPNshxUOjY0cZj), or bare 22-character IDs. The entity type (artist, album, track, playlist, show, episode) is auto-detected from the URL/URI. For a bare ID, the type set in 'Default type for bare IDs' is used. This is NOT a keyword search box — put search terms in 'Search queries' instead.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Free-text keywords to search across Spotify (e.g. 'arctic monkeys' or 'true crime podcast'). Each query returns the top results of every type — artists, albums, tracks, playlists, shows, and episodes. Use 'Results per type' to control how many of each. Leave empty if you only want to scrape specific URLs.", "items": { "type": "string" } }, "defaultType": { "title": "Default type for bare IDs", "enum": [ "artist", "album", "track", "playlist", "show", "episode" ], "type": "string", "description": "Entity type assumed when an input is a bare 22-character Spotify ID with no URL/URI context. Ignored for full URLs and URIs (those carry their own type). Defaults to 'artist'.", "default": "artist" }, "searchResultsPerType": { "title": "Search results per type", "minimum": 1, "maximum": 50, "type": "integer", "description": "For keyword searches, how many results to return per result type (artists, albums, tracks, playlists, shows, episodes). For example, 5 returns up to 5 artists + 5 albums + 5 tracks, and so on. Range 1-50. Defaults to 5. Does not affect direct URL scraping.", "default": 5 }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Hard cap on the total number of result records produced (and billed) across the whole run. Each scraped entity or search-result item counts as one result. Use it to control cost. Defaults to 50.", "default": 50 }, "responseFormat": { "title": "Response format", "enum": [ "concise", "detailed" ], "type": "string", "description": "'concise' returns the core record with the first ~50 nested items (album tracks, playlist tracks, show episodes) — ideal for AI agents and quick scans. 'detailed' paginates and includes all nested items up to 1000. Billing is identical (one charge per entity); 'detailed' only adds run time. Defaults to 'concise'.", "default": "concise" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for all requests. Spotify blocks datacenter IPs at its edge, so Apify Residential proxy is strongly recommended and enabled by default. Leave as-is unless you have a specific reason to change it.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```