***
### Frequently asked questions
#### Is it legal to scrape Spotify?
Scraping public data is generally allowed in the US and most of the EU, as long as you don't collect personal data that falls under GDPR or CCPA without a lawful basis. This actor only touches publicly accessible Spotify pages: the same pages a logged-out visitor sees in a browser. You're responsible for how you use the output. Apify has a detailed breakdown: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/).
#### How does it compare to Spotify's official Web API?
The official Web API requires you to register a developer app, manage OAuth, handle rate limits, and live with deprecations. It also doesn't expose per-track play counts, monthly listeners, world rank, or top cities. This actor gives you those fields with zero setup. The tradeoff: no ISRC, UPC, or audio features, which live behind the official API.
#### What happens on bad URLs, deleted artists, or private playlists?
The run succeeds with zero results for that specific URL plus a warning line in the log. You're billed $0 for failed lookups. No run-level failures on input mistakes. And if your account credit runs out mid-run, the actor stops cleanly instead of failing.
#### Does it work on K-pop, J-pop, Arabic, Hindi, and other non-Latin scripts?
Yes. Names come back in whatever script Spotify publishes: Hangul, Kanji, Cyrillic, Arabic, Devanagari, Thai, Hebrew, Simplified and Traditional Chinese. `intl-ko/`, `intl-ja/`, `intl-de/`, `intl-ar/`, and every other locale prefix is accepted. BTS (`3Nrfpe0tUJi4K4DXYWgMUX`), Arijit Singh (`4YRxDV8wJFPHPTeXepOstw`), and Amr Diab (`5abSRg0xN1NV3gLbuvX24M`) all return the full field set.
#### How fast is it?
2 to 5 seconds per entity at default memory (512 MB). A batch of 500 artists finishes in a few minutes. Playlists of up to 500 tracks paginate automatically in a single run.
#### What's the rate limit?
None you have to manage. The actor paces requests internally. No Spotify API quota to track, no 429s to retry, no OAuth to babysit.
#### Can I integrate Spotify Scraper with other tools?
Push results straight into **Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive**, and any webhook consumer. The Apify platform treats every actor as a webhook source. See [Apify integrations](https://docs.apify.com/platform/integrations).
#### Can I use it with the Apify API?
Yes. Minimal start-run call:
```bash
curl -X POST "https://api.apify.com/v2/acts/sourabhbgp~spotify-scraper/runs?token=APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"mode":"artist","spotifyUrls":["3TVXtAsR1Inumwj472S9r4"],"maxResults":1}'
```
Full docs: [Apify API reference](https://docs.apify.com/api/v2).
#### Can I use it through an MCP server (Claude Desktop, Cursor)?
Yes. Apify ships an MCP server that exposes every actor as a tool. Setup: [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp).
***
### Your feedback
Ran into a bug, want a new field, or need a different market covered? Drop a note in the [Issues tab](https://console.apify.com/actors/aM1fknsJVV253fDqf/issues). Every report goes to a human and fixes usually ship the same week.
# Actor input Schema
## `mode` (type: `string`):
What to scrape. Auto-detected from URL if not set.
## `searchTerm` (type: `string`):
Keyword to search Spotify catalog. Only used when mode=search.
## `includeDiscography` (type: `boolean`):
For artist mode: include full albums, singles, and popular releases lists in output. Default: off (returns counts only).
## `spotifyUrls` (type: `array`):
Spotify URLs, URIs, or raw IDs. Examples: https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4, spotify:artist:3TVXtAsR1Inumwj472S9r4, or just 3TVXtAsR1Inumwj472S9r4
## `maxResults` (type: `integer`):
Maximum number of entities to scrape. 0 = unlimited.
## Actor input object example
```json
{
"mode": "artist",
"includeDiscography": false,
"spotifyUrls": [
"https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4"
],
"maxResults": 50
}
```
# Actor output Schema
## `results` (type: `string`):
Scraped Spotify data.
# 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 '