# Spotify Artist Shop Scraper (`rainminer/spotify-artist-shop-scraper`) Actor Extract Spotify artist merch in seconds — paste a shop.spotify.com store or product URL and get titles, prices, currencies, images, variants, and availability. No coding required. Schedule runs, export JSON/CSV/Excel, and integrate via the Apify API. - **URL**: https://apify.com/rainminer/spotify-artist-shop-scraper.md - **Developed by:** [rainminer](https://apify.com/rainminer) (community) - **Categories:** E-commerce, AI, Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.59 / 1,000 products This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Artist Shop Scraper](https://storage.googleapis.com/pr-newsroom-wp/1/2023/05/Spotify_Full_Logo_RGB_Green.png) ### What does Spotify Artist Shop Scraper do? The **Spotify Artist Shop Scraper** is a no-code Apify Actor that **extracts merchandise data** from [Spotify Artist Shop](https://shop.spotify.com/) pages on **shop.spotify.com**. Paste an **artist store URL** or a **single product URL** and get structured **JSON** with **product titles**, **prices**, **currencies**, **availability**, **images**, **descriptions**, **size/color variants**, and links back to the public shop. It does **not** require the official Spotify API, a browser, or coding skills. Runs are **fast and lightweight** (HTTP-only) and work from Apify Console, the **API**, or scheduled jobs on the Apify platform. --- ### Why scrape Spotify Artist Shop data? Artists sell merch directly through **Spotify Artist Shop** — often powered by Shopify behind the scenes. That data is useful for: - **Merch monitoring** — Track new drops, sold-out items, and price changes for artists you follow. - **Catalog research** — Compare product types, price points, and currencies across multiple artist shops. - **Data pipelines** — Feed merch listings into dashboards, newsletters, or alerting workflows. - **E-commerce intelligence** — Build datasets of artist merchandise without manual copy-paste from shop pages. Combined with Apify, you can **schedule** daily runs, **export** results as **JSON, CSV, or Excel**, **monitor** failures, and **integrate** with Zapier, Make, or your own backend via the Apify API. --- ### What data can you extract from Spotify Artist Shop? | Field | Description | | ----- | ----------- | | `artistName` | Artist display name | | `artistId` | Spotify artist ID from the shop URL | | `artistStoreUrl` | Link to the artist's store page | | `title` | Product title | | `handle` | Product URL slug | | `url` | Public product page on shop.spotify.com | | `price` / `currency` | Listed price and currency (e.g. USD, CZK) | | `availableForSale` | Whether the item can be purchased | | `imageUrl` / `images` | Product image URLs | | `description` | Product description text | | `variants` | Sizes/options with per-variant price and availability | | `tags` / `productType` | Shopify tags and product type when present | --- ### What can this Spotify merch scraper do? - Scrape a full **artist store** (`/artist/{id}/store`) — up to **250 products** per shop. - Scrape a single **product page** (`/artist/{id}/product/{handle}`) with full variant details. - Support any **locale** in the URL (`en`, `cs`, `de`, etc.) — output links keep the same locale. - **Sort** listings by price or date; optionally **hide sold-out** items. - Limit results with **`maxItems` per start URL** for cost control. - Run **without a proxy** in most regions (proxy optional via input). --- ### How do I use Spotify Artist Shop Scraper to extract merch data? 1. Open the Actor in [Apify Console](https://console.apify.com/) and go to the **Input** tab. 2. Add one or more **Start URLs** — artist store or product links from [shop.spotify.com](https://shop.spotify.com/). 3. Set **Maximum items** (products per URL), **Hide sold out**, and **Sort products by** if needed. 4. Click **Start** and wait for the run to finish. 5. Download the dataset as **JSON**, **CSV**, or **Excel**, or fetch results via the **Apify API**. **Example store URL:** `https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/store` **Finding the artist ID:** Open the artist on [open.spotify.com](https://open.spotify.com), copy the ID from `open.spotify.com/artist/{artistId}`, then build `https://shop.spotify.com/en/artist/{artistId}/store`. --- ### How much does it cost to scrape Spotify Artist Shop? This Actor uses **pay-per-result** consumption on the Apify platform (Compute Units for HTTP requests and dataset storage). Typical store runs are **small and fast** — often well under **$0.01** per artist shop when scraping a handful of products, because no browser is launched. Exact cost depends on: - Number of **start URLs** and **maxItems** - Whether you enable **proxies** - Run frequency if **scheduled** Use the Apify **free plan** credits to test with a low `maxItems` value (default **5**) before scaling up. Check the Actor's pricing tab in Apify Store for current rates. --- ### Input Spotify Artist Shop Scraper has the following input options. See the **Input** tab in Apify Console for full field descriptions. | Field | Default | Description | | ----- | ------- | ----------- | | `startUrls` | — | **Required.** Store or product URLs on shop.spotify.com | | `maxItems` | `5` | Max products per start URL (1–250) | | `hideSoldOut` | `true` | Skip sold-out products | | `sortBy` | `date_desc` | `price_asc`, `price_desc`, `date_asc`, `date_desc` | | `proxyConfiguration` | no proxy | Optional Apify Proxy | **Example input:** ```json { "startUrls": [ { "url": "https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/store" } ], "maxItems": 10, "hideSoldOut": true, "sortBy": "date_desc", "proxyConfiguration": { "useApifyProxy": false } } ```` *** ### Output You can download the dataset extracted by Spotify Artist Shop Scraper in **JSON**, **HTML**, **CSV**, or **Excel**. Each row is one product. **Example output:** ```json { "artistId": "4ea8AWmXxlW0nX2ogATXiN", "artistName": "The.Switch", "artistImageUrl": "https://i.scdn.co/image/ab6761610000f178f190161a114f625687c66589", "artistStoreUrl": "https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/store", "productId": "gid://shopify/Product/14895447179590", "title": "Triko Pravda - unisex", "handle": "triko-pravda-unisex-1", "url": "https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/product/triko-pravda-unisex-1", "availableForSale": true, "price": 300, "currency": "CZK", "productType": null, "tags": [], "imageUrl": "https://cdn.shopify.com/s/files/1/0671/9101/3655/products/IMG_8069.jpg?v=1667809076", "images": [ "https://cdn.shopify.com/s/files/1/0671/9101/3655/products/IMG_8069.jpg?v=1667809076" ], "description": "", "variants": [ { "id": "gid://shopify/ProductVariant/54064989110598", "title": "XS", "availableForSale": true, "price": 300, "currency": "CZK" } ] } ``` *** ### Tips and advanced options - **Multiple artists** — Add several store URLs in `startUrls`; `maxItems` applies **per URL**. - **Product-only runs** — Use a product URL when you need full `description` and all `variants` for one item. - **Locale** — Use `/cs/`, `/en/`, or other locale segments in URLs; product links in the dataset match that locale. - **Empty shops** — Artists without an active Spotify shop return no products; verify the store loads in a browser first. - **API & scheduling** — Call the Actor via the Apify API or set a schedule to monitor merch changes over time. *** ### Is it legal to scrape Spotify Artist Shop? Our scrapers are ethical and only collect **publicly visible** product listing data shown on shop pages (titles, prices, images, availability). They do **not** extract private account data, payment details, or cart/checkout information. You are responsible for complying with [Spotify's terms](https://www.spotify.com/legal/end-user-agreement/) and applicable laws (including **GDPR** if personal data appears in your results). If unsure whether your use case is legitimate, consult a lawyer. Read Apify's guide on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### FAQ #### Does this use the official Spotify API? No. The Actor reads public shop pages and storefront data the same way a browser would, without requiring Spotify API credentials. #### Can I search by artist name instead of URL? Not in the current version — you need a **store or product URL** with the Spotify **artist ID** in the path. Find the ID from an `open.spotify.com/artist/...` link. #### Why are prices in CZK, USD, or another currency? Currency follows each shop's storefront settings and the locale in your start URL. #### The run returned zero products The artist may not have an active shop, or all items may be sold out with **Hide sold out** enabled. Try opening the same URL in a browser. #### Need help or a custom feature? Open an issue on the Actor's **Issues** tab in Apify Console or contact the maintainer for custom integrations. *** ### Image Credit Image credit: [Spotify](https://www.spotify.com/) / [Spotify Artist Shop](https://shop.spotify.com/) # Actor input Schema ## `startUrls` (type: `array`): Spotify Artist Shop store or product URLs to scrape. ## `maxItems` (type: `integer`): Maximum number of products to return per start URL. ## `hideSoldOut` (type: `boolean`): When enabled, sold-out products are excluded from results. ## `sortBy` (type: `string`): Sort order for store listing pages. ## `proxyConfiguration` (type: `object`): Proxy settings. The scraper works without a proxy in most regions. ## Actor input object example ```json { "startUrls": [ { "url": "https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/store" } ], "maxItems": 5, "hideSoldOut": true, "sortBy": "date_desc", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (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 = { "startUrls": [ { "url": "https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/store" } ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("rainminer/spotify-artist-shop-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 = { "startUrls": [{ "url": "https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/store" }], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("rainminer/spotify-artist-shop-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 '{ "startUrls": [ { "url": "https://shop.spotify.com/cs/artist/4ea8AWmXxlW0nX2ogATXiN/store" } ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call rainminer/spotify-artist-shop-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rainminer/spotify-artist-shop-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spotify Artist Shop Scraper", "description": "Extract Spotify artist merch in seconds — paste a shop.spotify.com store or product URL and get titles, prices, currencies, images, variants, and availability. No coding required. Schedule runs, export JSON/CSV/Excel, and integrate via the Apify API.", "version": "1.0", "x-build-id": "9AsEC07GIRUX36Xar" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rainminer~spotify-artist-shop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rainminer-spotify-artist-shop-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/rainminer~spotify-artist-shop-scraper/runs": { "post": { "operationId": "runs-sync-rainminer-spotify-artist-shop-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/rainminer~spotify-artist-shop-scraper/run-sync": { "post": { "operationId": "run-sync-rainminer-spotify-artist-shop-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Spotify Artist Shop store or product URLs to scrape.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum number of products to return per start URL.", "default": 5 }, "hideSoldOut": { "title": "Hide sold out", "type": "boolean", "description": "When enabled, sold-out products are excluded from results.", "default": true }, "sortBy": { "title": "Sort products by", "enum": [ "price_asc", "price_desc", "date_asc", "date_desc" ], "type": "string", "description": "Sort order for store listing pages.", "default": "date_desc" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. The scraper works without a proxy in most regions." } } }, "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 } } } } } } } } } } ```