# Free Spotify Artist Analytics (`s-r/free-spotify-artist-analytics`) Actor

- **URL**: https://apify.com/s-r/free-spotify-artist-analytics.md
- **Developed by:** [SR](https://apify.com/s-r) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 2 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## 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

## Free Spotify Artist Analytics — Monthly Listeners, World Rank & Top Tracks API

Pull the Spotify artist analytics fields the official Web API hides:
**monthly listeners**, **world rank**, **per-track playcount**, follower
count, related artists, biography, and full discography counts. One JSON
record per artist, no Spotify account required, $0.015 per artist.

### What you get

- `stats.monthly_listeners` — the headline number Spotify shows on the
  artist page (e.g. `82,461,902` for Taylor Swift). **Not available in
  the official Spotify Web API.**
- `stats.world_rank` — the artist's global ranking among all artists on
  Spotify (e.g. `#247 globally`). **Also not in the public API.**
- `stats.followers` — total Spotify followers
- `top_tracks[]` — the top 10 tracks with name, URI, **per-track
  playcount** (lifetime streams), duration, explicit flag, and the
  album they're on
- `related_artists[]` — the "Fans also like" list with each related
  artist's `monthly_listeners` already populated, so you can rank
  competitor reach without a second call
- `discography_counts` — albums / singles / compilations totals
- `biography`, `verified` flag, `external_links[]` (Instagram, Twitter,
  Wikipedia, etc.), avatar + header `images[]`
- `playlists_appears_on_count` — total editorial + user playlists
  featuring the artist

### Why scrape Spotify for artist analytics

The official Spotify Web API does **not** expose monthly listeners,
world rank, or per-track playcount on public artist endpoints. Spotify
keeps those numbers behind the artist's own Spotify-for-Artists login
and, for public consumption, only renders them on the
`open.spotify.com/artist/<id>` page. If you need this data for an
artist you don't own, the Web API returns `popularity` (a 0-100 black
box) and `followers` — and that's it. No streams, no listener counts,
no rank.

This actor solves that by hitting the same `pathfinder` GraphQL
endpoint Spotify's own web player uses, with anonymous embed-token
auth (no Spotify account, no OAuth dance, no premium subscription).
You get the exact fields Spotify renders to a logged-out browser —
clean, normalized JSON.

Real-world money math: an A&R scout at an indie label tracking 500
emerging artists weekly costs $7.50/run on this actor — versus
**Chartmetric Pro at ~$140/month** or **Soundcharts at $129/month** for
similar tracking, both of which are flat-rate subscriptions you pay
whether you use them or not. Indie artists benchmarking 20 competitors
in their genre spend $0.30 a run. Music supervisors building a
sync-licensing shortlist of 5,000 candidates pay $75 once.

### Input

| Field | Default | Description |
|---|---|---|
| `artists` | required | Array of Spotify artist IDs (22-char), URIs (`spotify:artist:<id>`), or `open.spotify.com/artist/<id>` URLs (incl. `/intl-xx/` locale paths) |
| `locale` | `""` (en) | Spotify locale for biography text. Examples: `en`, `nl`, `de`, `es`, `pt-br` |

The `artists` array accepts a mixed bag — bare IDs, full URLs with
locale prefixes, and `spotify:artist:` URIs all parse to the same ID.
Invalid inputs are returned with an `error` field instead of crashing
the run.

### Output

```json
{
  "uri": "spotify:artist:06HL4z0CvFAxyc27GXpf02",
  "id": "06HL4z0CvFAxyc27GXpf02",
  "name": "Taylor Swift",
  "verified": true,
  "biography": "Taylor Swift is a singer, songwriter, and...",
  "external_links": [
    {"name": "INSTAGRAM", "url": "https://instagram.com/taylorswift"},
    {"name": "TWITTER", "url": "https://twitter.com/taylorswift13"}
  ],
  "stats": {
    "followers": 121847562,
    "monthly_listeners": 82461902,
    "world_rank": 1
  },
  "discography_counts": {
    "albums": 14, "singles": 47, "compilations": 6, "top_tracks": 10
  },
  "top_tracks": [
    {
      "uri": "spotify:track:1BxfuPKGuaTgP7aM0Bbdwr",
      "id": "1BxfuPKGuaTgP7aM0Bbdwr",
      "name": "Cruel Summer",
      "playcount": 2847391045,
      "duration_ms": 178426,
      "explicit": false,
      "album_name": "Lover"
    }
  ],
  "related_artists": [
    {"name": "Olivia Rodrigo", "monthly_listeners": 41203847, "id": "1McMsnEElThX1knmY4oliG"}
  ],
  "playlists_appears_on_count": 24891
}
````

### Use cases

**Independent artist tracking competitors in their genre.** You're a
bedroom-pop artist with 12K monthly listeners. You feed in 30 artists
in your tier (15K-100K listeners) and pull their `top_tracks[]` with
playcounts. You instantly see which tracks are pulling weight, which
artists have stalled, and which related artists keep popping up across
your peer set — that's where to pitch for collabs and playlist
features. The whole sweep costs $0.45.

**Label A\&R scout monitoring breakthrough artists.** You watch 800
artists a week across hip-hop, alt-pop, and Latin. The number that
matters is `monthly_listeners` week-over-week — anyone jumping 30%+
in 7 days is a signal to dig in. Schedule the actor weekly, dump into
BigQuery, run a delta query. $12 a week beats Chartmetric Pro at $140+
and gives you raw fields to model on instead of a locked-down UI.

**Music supervisor building a sync-licensing pipeline.** You need
artists between 50K-500K monthly listeners (big enough to be
recognizable, small enough that licensing is affordable) in specific
moods. Pull 5,000 artist IDs from playlists in your target genre, run
this actor, filter on the `stats.monthly_listeners` band and
`external_links` for management contact paths. One $75 run gives you a
prioritized shortlist with biography snippets ready for your pitch
deck.

**Music PR / radio plugger reporting back to clients.** Your client
wants weekly proof of reach growth. Run the actor every Monday on the
client's artist ID, log `monthly_listeners`, `world_rank`, and the
top-3 `top_tracks` playcounts. Auto-generate the report. $0.015 per
client per week — and unlike Spotify-for-Artists screenshots, you get
historical world-rank deltas you can chart over time.

### How it compares

| Actor | Price | Monthly Listeners | World Rank | Per-track Playcount | Related Artists w/ listeners |
|---|---|---|---|---|---|
| **This actor** | **$0.015 / artist** | yes | yes | yes | yes |
| `scrapearchitect/spotify-artist-scraper` (#1 SERP) | per-result, similar tier | yes | no | partial | no |
| `easyapi/spotify-artists-scraper` | $2 + per-result | profile only | no | no | no |
| Spotify official Web API | free (with OAuth) | **no** | **no** | **no** | discontinued Nov 2024 |
| Chartmetric Pro | $140+ / month flat | yes | yes | yes | yes |
| Soundcharts Essential | $129+ / month flat | yes | yes (paid tier) | partial | yes |

The serious incumbents — Chartmetric, Soundcharts, Spotontrack — start
at $80-300/month flat-rate. If you're querying < 10,000 artists/month
this actor is dramatically cheaper, and you get raw JSON instead of a
dashboard you have to scrape back out.

The competitor Apify actors generally don't surface `monthly_listeners`

- `world_rank` together, and none of them include
  `related_artists[].monthly_listeners` in a single call.

### Pricing

- `$0.015` per artist returned
- All pricing is **pay-per-event** — you only pay per result. No
  actor-start fee, no monthly commitment, no idle compute charge.
- Errors (invalid input, deleted artist) are not billed.

### Limits and gotchas

- **Anonymous scraping** — no Spotify account, OAuth token, or premium
  subscription required. Auth uses the same embed-token Spotify gives
  to logged-out web players.
- **Rate limits** — Spotify throttles per-IP. The actor handles retries
  and token refresh automatically; expect ~1-2s per artist in steady
  state.
- **Locale affects biography only** — the `locale` input controls
  bio language, but stats and top tracks are global regardless.
- **`monthly_listeners` updates ~daily** on Spotify's side. Don't
  expect intra-day movement.
- **`world_rank` is global** — there's no per-country rank in the
  artist endpoint. For country-level chart positions, see the
  charts actor below.
- **Cold-start time** is ~5-8 seconds for the first artist (token
  fetch); subsequent artists in the same run reuse the token.
- **Deleted / region-blocked artists** return an `error` record with
  the original input and parsed ID — your downstream loader can skip
  cleanly.

### FAQ

**Can I get monthly listeners without the Spotify API?**
Yes. The official Spotify Web API does not return monthly listeners
for arbitrary artists — only `popularity` (0-100). This actor pulls
the exact `monthly_listeners` integer Spotify renders on the public
artist page, with no Spotify account required.

**How often does Spotify update monthly listeners?**
Spotify recalculates and publishes monthly listeners roughly every
24 hours. World rank moves on the same cadence. Run this actor daily
or weekly — running more frequently won't surface new data.

**Does this need a Spotify Premium account?**
No. Auth uses anonymous embed tokens — the same fallback Spotify uses
for logged-out browsers viewing embedded artist widgets. You don't
need a Spotify account at all.

**What's the cost to track 1000 artists weekly?**
$15 per week ($60/month). Compared to Chartmetric Pro at ~$140/month
or Soundcharts Essential at $129/month, this actor is the cheapest
path to artist-level analytics if your tracking list is under ~10,000
artists.

**How fresh is the data?**
Live at request time. Every call hits Spotify's current state — no
intermediate cache. If Spotify updated monthly listeners 30 minutes
ago, you get the new number 30 minutes later.

### Related Actors

- [Free Spotify Charts Scraper](https://apify.com/s-r/free-spotify-charts) — global Top Tracks / Albums / Artists weekly with rank deltas
- [Free Spotify Playlist Intelligence](https://apify.com/s-r/free-spotify-playlist-intelligence) — playlist tracklists, follower count, editorial flag, run-over-run diff
- [Free Spotify Podcast Catalog](https://apify.com/s-r/free-spotify-podcast-catalog) — show metadata, episodes, ratings, publisher

# Actor input Schema

## `artists` (type: `array`):

List of Spotify artist IDs (22-char), URIs (spotify:artist:...), or open.spotify.com URLs.

## `locale` (type: `string`):

Spotify locale (default: blank = en). Examples: en, nl, de, es.

## Actor input object example

```json
{
  "artists": [
    "06HL4z0CvFAxyc27GXpf02",
    "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4"
  ],
  "locale": ""
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "artists": [
        "taylor swift"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("s-r/free-spotify-artist-analytics").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "artists": ["taylor swift"] }

# Run the Actor and wait for it to finish
run = client.actor("s-r/free-spotify-artist-analytics").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 '{
  "artists": [
    "taylor swift"
  ]
}' |
apify call s-r/free-spotify-artist-analytics --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=s-r/free-spotify-artist-analytics",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Free Spotify Artist Analytics",
        "version": "0.1",
        "x-build-id": "aTyYP6WKRCRq0lA3W"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/s-r~free-spotify-artist-analytics/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-s-r-free-spotify-artist-analytics",
                "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/s-r~free-spotify-artist-analytics/runs": {
            "post": {
                "operationId": "runs-sync-s-r-free-spotify-artist-analytics",
                "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/s-r~free-spotify-artist-analytics/run-sync": {
            "post": {
                "operationId": "run-sync-s-r-free-spotify-artist-analytics",
                "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": [
                    "artists"
                ],
                "properties": {
                    "artists": {
                        "title": "Spotify artists",
                        "type": "array",
                        "description": "List of Spotify artist IDs (22-char), URIs (spotify:artist:...), or open.spotify.com URLs.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "locale": {
                        "title": "Locale",
                        "type": "string",
                        "description": "Spotify locale (default: blank = en). Examples: en, nl, de, es.",
                        "default": ""
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```