# Spotify Profile Details Scraper✨ (`scrapearchitect/spotify-profile-details-scraper`) Actor 🎡 Scrape any public Spotify user profile β€” no API key needed. Returns: πŸ†” user ID Β· πŸ‘€ display name Β· πŸ–ΌοΈ profile image Β· πŸ‘₯ follower & following counts Β· 🎀 up to 50 recently played artists with images 🎧 full playlist library with cover art & creation dates. πŸ‘₯Spotify Profile Details Scraper 🎧 - **URL**: https://apify.com/scrapearchitect/spotify-profile-details-scraper.md - **Developed by:** [Scrape Architect](https://apify.com/scrapearchitect) (community) - **Categories:** Social media, Developer tools, Automation - **Stats:** 8 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $10.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 Profile Scraper ✨ The **Spotify User-Profile Scraper** is a powerful, production-ready Apify Actor that extracts comprehensive public profile data from any Spotify user page β€” no API key, no login required. Simply provide one or more profile URLs and the Spotify User-Profile Scraper will return fully structured JSON with the user's name, follower counts, profile image, recently played artists, and complete playlist library with cover images and estimated creation dates. > ⚠️ **This actor is intentionally slow β€” please be patient.** > The Spotify User-Profile Scraper uses a real headless browser to render Spotify's JavaScript-heavy pages. Each profile requires multiple page loads with rendering delays. A single profile with a large playlist library can take **5–10 minutes** to complete. Enabling the **Include Playlists** and **Include Recently Played Artists** options adds extra page fetches and significantly increases run time. This is expected behaviour β€” do not stop the run early. The actor will push your results as soon as each profile is fully scraped. --- ### What Does the Spotify User-Profile Scraper Return? Every result row produced by the Spotify User-Profile Scraper contains the following fields: | Field | Type | Description | |---|---|---| | `source_url` | string | Original profile URL that was scraped | | `user_id` | string | Spotify user ID extracted from the URL | | `display_name` | string | Public display name of the user | | `profile_image` | string | CDN URL of the user's profile picture | | `followers` | string | Follower count as displayed (`"1,234 Followers"`) | | `followers_count` | integer | Follower count as an integer (`1234`) | | `following` | string | Following count as displayed (`"56 Following"`) | | `following_count` | integer | Following count as an integer (`56`) | | `total_public_playlists_count` | integer | Total number of public playlists | | `recently_played_artists` | array | Up to 50 recently played artists with name, URL, and image | | `playlists` | array | All public playlists with title, URL, cover image, and estimated creation date | #### Recently Played Artist Object ```json { "name": "Radiohead", "url": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb", "image": "https://i.scdn.co/image/ab676161000051..." } ```` #### Playlist Object ```json { "title": "fall 25", "url": "https://open.spotify.com/playlist/6TWR9qj0MC1kVu3N1rwMBE", "image": "https://image-cdn-ak.spotifycdn.com/image/...", "created_at_proxy": "Oct 2025" } ``` *** ### Key Features of the Spotify User-Profile Scraper - **No API key required** β€” the Spotify User-Profile Scraper works on fully public profile pages without any authentication - **Up to 50 recently played artists** β€” with artist images, not just the 10 shown on the profile homepage - **Full playlist library** β€” all public playlists scraped from the `/playlists` subpage with lazy-loaded cover images - **Estimated playlist creation dates** β€” the Spotify User-Profile Scraper visits each playlist page to extract the oldest track date as a creation proxy - **Integer + text counts** β€” both `followers_count: 1234` and `followers: "1,234 Followers"` are returned for easy filtering - **Concurrent processing** β€” up to 10 profiles scraped in parallel; each result is pushed to the dataset as soon as it is complete - **Configurable output** β€” toggle playlists and recently played artists on/off independently - **K/M suffix support** β€” large follower counts like `"2.4K"` or `"1.2M"` are correctly parsed to integers *** ### Input Configuration The Spotify User-Profile Scraper accepts the following input fields: | Input | Type | Default | Description | |---|---|---|---| | `profileUrls` | string\[] | β€” | **Required.** One or more Spotify user profile URLs | | `includePlaylists` | boolean | `true` | Scrape all public playlists with images and creation dates. **⚠️ Enabling this significantly increases run time** β€” each playlist requires an individual page load to fetch its creation date. | | `includeRecentlyPlayedArtists` | boolean | `true` | Scrape the full recently played artists list (up to 50 with images). **⚠️ Enabling this adds an extra page fetch per profile.** | #### Example Input ```json { "profileUrls": [ "https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd", "https://open.spotify.com/user/spotify" ], "includePlaylists": true, "includeRecentlyPlayedArtists": true } ``` > Profile URLs must be in the format `https://open.spotify.com/user/`. Artist, album, and playlist URLs are not supported by this actor. *** ### Use Cases for the Spotify User-Profile Scraper The Spotify User-Profile Scraper is well suited for a wide range of data workflows: - **Influencer research** β€” identify music taste, playlist reach, and follower counts for potential collaborators - **Audience analysis** β€” understand what artists a user's followers are listening to recently - **Playlist discovery** β€” bulk-collect public playlist libraries from curators and tastemakers - **Music journalism** β€” track listening habits and newly public playlists over time - **Academic research** β€” build datasets of Spotify listening behaviour from public profiles - **Social media tooling** β€” enrich Spotify user data with profile images and follower metrics *** ### Example Output ```json { "source_url": "https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd", "user_id": "7zyu0di3zv7s4seuyrp6otzzd", "display_name": "sun", "profile_image": "https://i.scdn.co/image/ab6775700000ee85f3a000b3d4254a6ad42c633f", "followers": "55 Followers", "followers_count": 55, "following": "62 Following", "following_count": 62, "total_public_playlists_count": 87, "recently_played_artists": [ { "name": "Radiohead", "url": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb", "image": "https://i.scdn.co/image/ab676161000051..." } ], "playlists": [ { "title": "fall 25", "url": "https://open.spotify.com/playlist/6TWR9qj0MC1kVu3N1rwMBE", "image": "https://image-cdn-ak.spotifycdn.com/image/...", "created_at_proxy": "Oct 2025" } ] } ``` *** ### Performance & Cost > ⚠️ **The Spotify User-Profile Scraper is a slow actor by nature. Please be patient and do not stop the run early.** > Spotify's web app is fully JavaScript-rendered, so each page requires a headless browser with deliberate rendering delays. Turning on **Include Playlists** adds one extra HTTP request per playlist (to fetch creation dates), and turning on **Include Recently Played Artists** adds one more full page fetch per profile. Both options together represent the maximum possible run time β€” but they also give you the richest dataset. | Scenario | Approx. time | |---|---| | 1 profile, playlists **off**, artists **off** | ~8 s | | 1 profile, playlists **off**, artists **on** | ~13 s | | 1 profile, playlists **on** (87 playlists), artists **off** | ~5–6 min | | 1 profile, playlists **on** (87 playlists), artists **on** | ~6–7 min | | 10 profiles in parallel (playlists **on**, artists **on**) | ~8–15 min | The dominant time driver is **playlist creation date fetching** β€” every playlist in a user's library needs its own page load. With the built-in concurrency, a 100-playlist library alone takes 3–5 minutes. Users with 200+ playlists may take 10+ minutes per profile. **Tip:** If you only need basic profile data (name, followers, profile image) and don't need playlists or artist history, turn **both toggles off** β€” the actor will complete in under 10 seconds per profile. *** ### Frequently Asked Questions **Does the Spotify User-Profile Scraper require a Spotify account or API key?** No. The Spotify User-Profile Scraper only accesses public profile pages that are visible to any logged-out visitor. No credentials of any kind are needed. **What profile URLs does the Spotify User-Profile Scraper support?** Only `https://open.spotify.com/user/` URLs. Artist pages, album pages, and playlist pages are handled by a separate actor. **How many profiles can the Spotify User-Profile Scraper process at once?** You can submit any number of URLs β€” the Spotify User-Profile Scraper will queue and process them automatically. **Why is the `created_at_proxy` field the estimated date and not an exact date?** Spotify does not expose playlist creation dates publicly. The Spotify User-Profile Scraper uses the oldest track-added date visible in the playlist as a reliable creation proxy. **What happens if a profile is private or does not exist?** The Spotify User-Profile Scraper will return a result object with a populated `source_url` and an `error` field describing the failure. Other profiles in the same run are not affected. *** ### Limitations - Only **public** Spotify profiles are supported - The `recently_played_artists` list reflects what Spotify shows on the public profile page (up to 50 artists) - Playlist creation dates are **estimated** via the oldest visible added-date - Spotify's page structure may change; if fields become `null` after a Spotify update, the actor may require a maintenance update *** *The Spotify User-Profile Scraper is an independent tool and is not affiliated with, endorsed by, or connected to Spotify Technology S.A. Use responsibly and in accordance with Spotify's Terms of Service.* # Actor input Schema ## `profileUrls` (type: `array`): One or more Spotify user profile URLs to scrape. Each URL produces one result entry. Example: https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd ## `includePlaylists` (type: `boolean`): When ON β€” scrapes all public playlists including title, URL, cover image, and estimated creation date. ⚠️ SLOW: each playlist requires a separate page load to fetch its creation date. A profile with 80+ playlists can add 5–10 minutes to the run time. Be patient and do not stop the run early. When OFF β€” playlists are skipped and the run completes much faster. ## `includeRecentlyPlayedArtists` (type: `boolean`): When ON β€” scrapes up to 50 recently played artists including artist name, URL, and artist image. ⚠️ SLOW: fetching this page adds extra browser rendering time (~5 s) per profile. When OFF β€” the recently\_played\_artists field is omitted and the run is faster. ## Actor input object example ```json { "profileUrls": [ "https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd" ], "includePlaylists": false, "includeRecentlyPlayedArtists": false } ``` # 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 = { "profileUrls": [ "https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapearchitect/spotify-profile-details-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 = { "profileUrls": ["https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd"] } # Run the Actor and wait for it to finish run = client.actor("scrapearchitect/spotify-profile-details-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 '{ "profileUrls": [ "https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd" ] }' | apify call scrapearchitect/spotify-profile-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapearchitect/spotify-profile-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spotify Profile Details Scraper✨", "description": "🎡 Scrape any public Spotify user profile β€” no API key needed. Returns: πŸ†” user ID Β· πŸ‘€ display name Β· πŸ–ΌοΈ profile image Β· πŸ‘₯ follower & following counts Β· 🎀 up to 50 recently played artists with images 🎧 full playlist library with cover art & creation dates. πŸ‘₯Spotify Profile Details Scraper 🎧", "version": "1.0", "x-build-id": "y8Vtimn4vQxgpiXxw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapearchitect~spotify-profile-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapearchitect-spotify-profile-details-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-profile-details-scraper/runs": { "post": { "operationId": "runs-sync-scrapearchitect-spotify-profile-details-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-profile-details-scraper/run-sync": { "post": { "operationId": "run-sync-scrapearchitect-spotify-profile-details-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": [ "profileUrls" ], "properties": { "profileUrls": { "title": "πŸ‘€ Spotify Profile URLs", "type": "array", "description": "One or more Spotify user profile URLs to scrape. Each URL produces one result entry.\nExample: https://open.spotify.com/user/7zyu0di3zv7s4seuyrp6otzzd", "items": { "type": "string" } }, "includePlaylists": { "title": "🎧 Include Public Playlists", "type": "boolean", "description": "When ON β€” scrapes all public playlists including title, URL, cover image, and estimated creation date. ⚠️ SLOW: each playlist requires a separate page load to fetch its creation date. A profile with 80+ playlists can add 5–10 minutes to the run time. Be patient and do not stop the run early.\nWhen OFF β€” playlists are skipped and the run completes much faster.", "default": false }, "includeRecentlyPlayedArtists": { "title": "🎀 Include Recently Played Artists", "type": "boolean", "description": "When ON β€” scrapes up to 50 recently played artists including artist name, URL, and artist image. ⚠️ SLOW: fetching this page adds extra browser rendering time (~5 s) per profile.\nWhen OFF β€” the recently_played_artists field is omitted and the run is faster.", "default": false } } }, "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 } } } } } } } } } } ```