# Spotify Playlists Scraper (`scrapearchitect/spotify-playlists-scraper`) Actor šŸŽ§ Spotify Playlists Scraper šŸ” is a high-performance tool that extracts šŸ“‚ detailed playlist data from Spotify using keyword searches! Get šŸŽ¶ playlist titles, šŸ‘¤ owners, šŸŒŸ followers, šŸŽ¼ track names, ā± durations, and šŸ”„ popularity ratings in seconds. perfect for šŸ“Š research, šŸ“ˆ trend analysis - **URL**: https://apify.com/scrapearchitect/spotify-playlists-scraper.md - **Developed by:** [Scrape Architect](https://apify.com/scrapearchitect) (community) - **Categories:** Social media, Other, Videos - **Stats:** 89 total users, 5 monthly users, 100.0% runs succeeded, 7 bookmarks - **User rating**: No ratings yet ## Pricing $5.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 Playlist Scraper - Extract Complete Playlist Data from Spotify ### What Is the Spotify Playlist Scraper? The **Spotify Playlist Scraper** is a dedicated Apify actor for extracting playlist data from Spotify. This Spotify Playlist Scraper supports two modes: a fast mode that extracts basic playlist metadata, and a detail mode that fetches complete track listings with artist information, album names, durations, and popularity scores. The Spotify Playlist Scraper accepts both search keywords and direct Spotify playlist URLs. The Spotify Playlist Scraper paginates all playlist tracks automatically. There are no hidden limits - the Spotify Playlist Scraper fetches as many playlists as you request and retrieves all tracks per playlist when detail mode is enabled. --- ### Why Use This Spotify Playlist Scraper? - **Two scraping modes** - the Spotify Playlist Scraper offers a fast metadata mode and a detailed track listing mode. - **Complete track listings** - the Spotify Playlist Scraper fetches every track in a playlist with no hidden caps. - **Full pagination** - playlist tracks are paginated in batches by the Spotify Playlist Scraper until the complete listing is returned. - **Keyword and URL input** - the Spotify Playlist Scraper supports both search keywords and direct Spotify playlist URLs. - **Track popularity scores** - the Spotify Playlist Scraper returns popularity data for each track in detail mode. - **Total duration** - the Spotify Playlist Scraper computes formatted total duration of all fetched tracks. - **Clean JSON output** - the Spotify Playlist Scraper delivers structured data ready for any data pipeline. --- ### Input Options for the Spotify Playlist Scraper | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchMode` | string | `"keyword"` | Choose `"keyword"`, `"url"`, or `"both"` for the Spotify Playlist Scraper input. | | `keywords` | array | `[]` | Search terms for the Spotify Playlist Scraper to query. | | `urls` | array | `[]` | Direct Spotify playlist URLs for the Spotify Playlist Scraper. | | `maxResults` | integer | `3` | Maximum playlists per keyword. The Spotify Playlist Scraper has no hidden cap. | | `fetchDetails` | boolean | `true` | Set to `true` for the Spotify Playlist Scraper to fetch full track listings. Set to `false` for fast metadata-only mode. | | `trackLimit` | integer | `0` | Maximum tracks per playlist. Use `0` for the Spotify Playlist Scraper to fetch all tracks. | | `proxyCountry` | string | `"US"` | Proxy exit country for the Spotify Playlist Scraper. | --- ### Output Fields from the Spotify Playlist Scraper #### Fast Mode (fetchDetails = false) The Spotify Playlist Scraper returns these fields in fast mode: | Field | Type | Description | |-------|------|-------------| | `playlist_id` | string | Unique Spotify playlist ID. | | `playlist_title` | string | Playlist title. | | `playlist_url` | string | Direct Spotify URL to the playlist. | | `playlist_owner` | string | Username of the playlist creator. | | `owner_url` | string | Spotify profile URL of the owner. | | `playlist_description` | string | Playlist description text. | | `playlist_image` | string | Playlist cover image URL. | #### Detail Mode (fetchDetails = true) In detail mode, the Spotify Playlist Scraper adds these additional fields: | Field | Type | Description | |-------|------|-------------| | `playlist_followers` | integer | Follower count of the playlist. | | `total_tracks` | integer | Total tracks in the playlist. | | `total_duration_for_requested_tracks` | string | Formatted total duration (e.g., `"2h 15m 30s"`). | | `tracks` | array | Array of track objects (see below). | **Track objects inside `tracks` array from the Spotify Playlist Scraper:** | Field | Type | Description | |-------|------|-------------| | `tracks[].track_title` | string | Track title. | | `tracks[].artists` | array | Artist names on this track. | | `tracks[].album_name` | string | Album containing this track. | | `tracks[].duration` | string | Formatted duration (e.g., `"3m 45s"`). | | `tracks[].artist_urls` | array | Spotify URLs for each artist. | | `tracks[].track_url` | string | Spotify URL to the track. | | `tracks[].album_url` | string | Spotify URL to the album. | | `tracks[].tracks popularity` | string | Popularity score of the track. | --- ### Example Output from the Spotify Playlist Scraper (Detail Mode) ```json { "playlist_id": "37i9dQZF1DXcBWIGoYBM5M", "playlist_title": "Today's Top Hits", "playlist_url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "playlist_owner": "spotify", "owner_url": "https://open.spotify.com/user/spotify", "playlist_followers": 35487621, "total_tracks": 50, "total_duration_for_requested_tracks": "2h 45m 12s", "playlist_description": "The biggest songs right now.", "playlist_image": "https://i.scdn.co/image/...", "tracks": [ { "track_title": "Espresso", "artists": ["Sabrina Carpenter"], "album_name": "Short n' Sweet", "duration": "2m 55s", "artist_urls": ["https://open.spotify.com/artist/74KM79TiuVKeVCqs8QtB0B"], "track_url": "https://open.spotify.com/track/2qSkIjg1o9h3YT9RAgYN75", "album_url": "https://open.spotify.com/album/1q9Q1YOOEBpnPJTsNJLs6c", "tracks popularity": "95" } ] } ```` *** ### How the Spotify Playlist Scraper Works 1. **Search or Load** - The Spotify Playlist Scraper either searches Spotify for playlists matching your keywords or loads them directly from URLs. 2. **Metadata Extraction** - For each playlist, the Spotify Playlist Scraper extracts the ID, title, owner, description, and cover image. 3. **Detail Fetching** - If `fetchDetails` is enabled, the Spotify Playlist Scraper makes additional API calls to get follower count, total tracks, and the complete track listing. 4. **Track Pagination** - The Spotify Playlist Scraper fetches playlist tracks in batches until the complete listing is retrieved. If `trackLimit` is set, the Spotify Playlist Scraper stops at that count. 5. **Duration Calculation** - The Spotify Playlist Scraper computes the formatted total duration across all fetched tracks. 6. **Data Output** - Each playlist record is pushed to the Apify dataset as structured JSON. *** ### Use Cases for the Spotify Playlist Scraper - **Playlist analysis** - Use the Spotify Playlist Scraper to study track composition and genre distribution across playlists. - **Competitive research** - Analyze competitor playlists using the Spotify Playlist Scraper to understand curation strategies. - **Music discovery tools** - The Spotify Playlist Scraper provides structured playlist data for recommendation systems. - **Follower tracking** - Track playlist popularity over time by running the Spotify Playlist Scraper periodically. - **Data integration** - The Spotify Playlist Scraper delivers JSON output that integrates directly with databases and BI tools. *** ### Related Spotify Scrapers and Tools by ScrapeArchitect | Actor | Description | Link | |-------|-------------|------| | All-in-One Spotify Scraper | The ultimate Spotify scraper with 6 operation modes | [View on Apify](https://apify.com/scrapearchitect/all-in-one-spotify-scraper-downloader) | | Spotify Artist Scraper | Dedicated Spotify artist profile scraper | [View on Apify](https://apify.com/scrapearchitect/spotify-artist-scraper) | | Spotify Tracks Scraper | Lightweight Spotify track metadata scraper | [View on Apify](https://apify.com/scrapearchitect/spotify-tracks-scraper-basic-mode) | | Spotify Album Scraper | Dedicated Spotify album scraper with full track listings | [View on Apify](https://apify.com/scrapearchitect/spotify-album-scraper) | | Spotify Tracks Scraper - Advanced Filtering | Spotify track scraper with sorting and filtering | [View on Apify](https://apify.com/scrapearchitect/spotify-track-scraper-with-advanced-filtering) | | Spotify Tracks Downloader - Advanced Filters | Download Spotify tracks with advanced filter options | [View on Apify](https://apify.com/scrapearchitect/spotify-tracks-downloader-advanced-filters-unlocked) | | Spotify Music Downloader - Fast Mode | Standalone fast-mode Spotify downloader | [View on Apify](https://apify.com/scrapearchitect/spotify-tracks-music-downloader-Fast) | | Spotify Music Downloader - Accurate Mode | Standalone accurate-mode Spotify downloader | [View on Apify](https://apify.com/scrapearchitect/spotify-music-downloader-Accurate) | | Spotify Tracks Downloader | Simple fast Spotify tracks downloader | [View on Apify](https://apify.com/scrapearchitect/spotify-tracks-downloader) | *** ### Notes - This Spotify Playlist Scraper runs on the Apify platform. No Spotify API key or login is required. - The Spotify Playlist Scraper uses public Spotify web endpoints exclusively. - Output from the Spotify Playlist Scraper is available in JSON, CSV, Excel, or via the Apify dataset API. - For more data types beyond playlists, use the all-in-one Spotify Scraper. # Actor input Schema ## `keywords` (type: `array`): Enter keywords to search for playlists (search is performed on playlist titles). ## `maxResults` (type: `integer`): Maximum number of playlists per keyword (no limit) ## `fetchDetails` (type: `boolean`): When enabled, fetches comprehensive playlist details (track listings, followers, durations) via additional API calls per result. Provides richer data but takes significantly longer for large result sets. When disabled (default), returns search-only data for maximum speed. ## `track_limit` (type: `integer`): How many tracks to retrieve per playlist. Use 0 to fetch all available tracks. ## `proxyCountry` (type: `string`): Residential proxy exit country ā€” Spotify sees your requests as coming from this location. ā­ US recommended ā€” widest catalog and most reliable. If results are empty, try switching to US. If US still returns empty, it is a script or API issue ā€” create an issue for confirmation. ## Actor input object example ```json { "keywords": [ "chill", "workout" ], "maxResults": 5, "fetchDetails": false, "track_limit": 3, "proxyCountry": "US" } ``` # 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 = { "keywords": [ "chill", "workout" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapearchitect/spotify-playlists-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 = { "keywords": [ "chill", "workout", ] } # Run the Actor and wait for it to finish run = client.actor("scrapearchitect/spotify-playlists-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 '{ "keywords": [ "chill", "workout" ] }' | apify call scrapearchitect/spotify-playlists-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapearchitect/spotify-playlists-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spotify Playlists Scraper", "description": "šŸŽ§ Spotify Playlists Scraper šŸ” is a high-performance tool that extracts šŸ“‚ detailed playlist data from Spotify using keyword searches! Get šŸŽ¶ playlist titles, šŸ‘¤ owners, šŸŒŸ followers, šŸŽ¼ track names, ā± durations, and šŸ”„ popularity ratings in seconds. perfect for šŸ“Š research, šŸ“ˆ trend analysis", "version": "1.0", "x-build-id": "16baKwyIS4aHXgwHH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapearchitect~spotify-playlists-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapearchitect-spotify-playlists-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/scrapearchitect~spotify-playlists-scraper/runs": { "post": { "operationId": "runs-sync-scrapearchitect-spotify-playlists-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/scrapearchitect~spotify-playlists-scraper/run-sync": { "post": { "operationId": "run-sync-scrapearchitect-spotify-playlists-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", "required": [ "keywords" ], "properties": { "keywords": { "title": "šŸ”‘ Search Keywords", "type": "array", "description": "Enter keywords to search for playlists (search is performed on playlist titles).", "items": { "type": "string" } }, "maxResults": { "title": "šŸŽÆ Max Results per Keyword", "minimum": 1, "type": "integer", "description": "Maximum number of playlists per keyword (no limit)", "default": 5 }, "fetchDetails": { "title": "šŸ” Fetch Full Details", "type": "boolean", "description": "When enabled, fetches comprehensive playlist details (track listings, followers, durations) via additional API calls per result. Provides richer data but takes significantly longer for large result sets. When disabled (default), returns search-only data for maximum speed.", "default": false }, "track_limit": { "title": "šŸŽµ Tracks per Playlist", "minimum": 0, "type": "integer", "description": "How many tracks to retrieve per playlist. Use 0 to fetch all available tracks.", "default": 3 }, "proxyCountry": { "title": "šŸŒ Proxy Country", "enum": [ "US", "GB", "AU", "CA", "DE", "FR", "NL", "IT", "ES", "SE", "NO", "DK", "FI", "BE", "AT", "CH", "IE", "PL", "PT", "CZ", "HU", "RO", "GR", "BG", "HR", "SK", "RS", "JP", "KR", "SG", "HK", "TW", "TH", "MY", "ID", "PH", "VN", "IN", "BR", "MX", "AR", "CL", "CO", "PE", "ZA", "NG", "KE", "EG", "SA", "AE", "TR", "IL", "UA", "RU", "BY" ], "type": "string", "description": "Residential proxy exit country ā€” Spotify sees your requests as coming from this location.\n\nā­ US recommended ā€” widest catalog and most reliable.\n\nIf results are empty, try switching to US. If US still returns empty, it is a script or API issue ā€” create an issue for confirmation.", "default": "US" } } }, "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 } } } } } } } } } } ```