Spotify API endpoint
Returns public Spotify follower profiles. Spotify exposes this publicly for some profiles; private or restricted profiles may return an upstream error.
/spotify/profile/followersMCP tool: spotify_profile_followers
Returns public follower profiles from a Spotify profile. Provide one of username, uri, or url; when omitted the endpoint defaults to Spotify's official profile.
| Name | Required | Description |
|---|---|---|
username | No | Spotify username, for example spotify. |
uri | No | Spotify user URI, for example spotify:user:spotify. |
url | No | Open Spotify user URL, for example https://open.spotify.com/user/spotify. |
offset | No | Follower offset applied locally after Spotify returns the public follower set. |
limit | No | Follower limit, clamped to 1..200. |
| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| uri | 50 | |
| username | 50 | |
| name | 50 | |
| followersCount | 50 | 1,619 to 46,527, median 3,098 |
| color | 50 | 1,697,420 to 16,737,335, median 13,139,285 |
| externalUrl | 50 | open.spotify.com |
| imageUrl | 2 | i.scdn.co |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| username | string | No | Spotify username | spotify | |
| uri | string | No | Spotify user URI | spotify:user:spotify | |
| url | string | No | open.spotify.com user URL | https://open.spotify.com/user/spotify | |
| offset | integer | No | Follower offset applied locally | 0 | |
| limit | integer | No | Follower limit, clamped to 1-200 | 50 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/spotify/profile/followers?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"uri": "spotify:user:spotify",
"username": "spotify",
"offset": 0,
"limit": 50,
"total": 998,
"profiles": [
{
"uri": "spotify:user:example",
"username": "example",
"name": "Example"
}
]
}Request schema
No body schema
Response schema
#/definitions/spotify.userProfileFollowersResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | spotify.UserProfileFollowersResponse | No | ||||
| data.limit | integer | No | 50 | Maximum number of followers requested. | ||
| data.meta | object | No | Details about this response. | |||
| data.meta.appVersion | string | No | 1.2.90.403.gf901f20f | Version of the Spotify web player the data was read from. | ||
| data.meta.artistCount | integer | No | 0 | Number of recently played artists returned. | ||
| data.meta.fetchedAt | string | No | 2026-05-13T20:41:12Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.meta.operationName | string | No | userProfileView | Name of the Spotify web player operation that returned the data. | ||
| data.meta.playlistCount | integer | No | 10 | Number of playlists returned. | ||
| data.meta.profileCount | integer | No | 50 | Number of user profiles returned. | ||
| data.offset | integer | No | 0 | Position of the first follower returned. | ||
| data.profiles | array | No | Follower profiles returned. | |||
| data.profiles[].color | integer | No | 16085920 | Accent color of the profile, as a number. | ||
| data.profiles[].externalUrl | string | No | https://open.spotify.com/user/example | Link to the user's profile on open.spotify.com. | ||
| data.profiles[].followersCount | integer | No | 1000 | Number of followers the user has. | ||
| data.profiles[].imageUrl | string | No | https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5 | URL of the user's profile image. | ||
| data.profiles[].isFollowing | boolean | No | false | Whether Spotify marks the user as followed. | ||
| data.profiles[].name | string | No | Example | Display name of the user. | ||
| data.profiles[].uri | string | No | spotify:user:example | Spotify URI of the user. | ||
| data.profiles[].username | string | No | example | Spotify username of the user. | ||
| data.total | integer | No | 998 | Total number of followers the user has. | ||
| data.uri | string | No | spotify:user:spotify | Spotify URI of the user. | ||
| data.username | string | No | spotify | Spotify username of the user. | ||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid parameters | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 503 | Spotify upstream request failed | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/spotify/profile/followers?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"