Retrieve Spotify public profile

Returns normalized public profile metadata and preview playlists from Spotify's Web Player user-profile service. Provide username, uri, or url; defaults to Spotify's official profile.

GETapiKey3 credits/requestSpotifyspotify.userProfileResponseDoc/spotify/profile

Overview

Returns normalized public profile metadata and preview playlists from Spotify's Web Player user-profile service. Provide username, uri, or url; defaults to Spotify's official profile.

View Spotify platform page Open in Playground Copy language examples

Request schema

Name	In	Type	Required	Example	Description
username	query	string	No	spotify	Spotify username
uri	query	string	No	spotify:user:spotify	Spotify user URI
url	query	string	No	https://open.spotify.com/user/spotify	open.spotify.com user URL
playlist_limit	query	integer	No	10	Embedded public playlist limit, clamped to 0-50
artist_limit	query	integer	No	10	Recently played artist limit, clamped to 0-50
episode_limit	query	integer	No	0	Embedded episode limit, clamped to 0-50
x-api-key	header	string	Yes		API key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 3 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

Proxy strategy: managed automatically where needed
Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
Browser cluster: supported dynamic workloads can be routed through distributed browser instances
Retry behavior: automatic retry/fallback may be used depending on endpoint type
Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
Billing: credits are charged only for successful 2xx responses
Observability: responses include request context where available

MCP

MCP URL: https://mcp.crawlora.net/mcp
Tool name: spotify.profile
Transport: Streamable HTTP
Docs resource: docs://index

Response behavior

The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

Status	Common failure case
400	Invalid input or missing required parameter
429	Plan or endpoint rate limit exceeded
500	Internal execution error
502	Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Failure responses

Status	Description	Schema
400	Missing or invalid parameters	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
502	Spotify upstream request failed	#/definitions/app.Response

Example response

{
  "uri": "spotify:user:spotify",
  "username": "spotify",
  "name": "Spotify",
  "followersCount": 12162371,
  "followingCount": 327,
  "totalPublicPlaylistsCount": 1519,
  "publicPlaylists": [
    {
      "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M",
      "name": "Today’s Top Hits",
      "ownerName": "Spotify"
    }
  ]
}

Request schema

No body schema

Response schema

#/definitions/spotify.userProfileResponseDoc

Field	Type	Required	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.UserProfileResponse	No
data.allowFollows	boolean	No	true
data.color	integer	No	16085920
data.externalUrl	string	No	https://open.spotify.com/user/spotify
data.followersCount	integer	No	12162371
data.followingCount	integer	No	327
data.hasSpotifyImage	boolean	No	true
data.hasSpotifyName	boolean	No	true
data.imageUrl	string	No	https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5
data.isCurrentUser	boolean	No	false
data.isVerified	boolean	No	true
data.meta	spotify.UserProfileMeta	No
data.meta.appVersion	string	No	1.2.90.403.gf901f20f
data.meta.artistCount	integer	No	0
data.meta.fetchedAt	string	No	2026-05-13T20:41:12Z
data.meta.operationName	string	No	userProfileView
data.meta.playlistCount	integer	No	10
data.meta.profileCount	integer	No	50
data.name	string	No	Spotify
data.publicPlaylists	array	No
data.publicPlaylists[].externalUrl	string	No	https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M
data.publicPlaylists[].followersCount	integer	No	34324513
data.publicPlaylists[].id	string	No	37i9dQZF1DXcBWIGoYBM5M
data.publicPlaylists[].imageUrl	string	No	https://i.scdn.co/image/ab67706f0000000273f7bb6e77ec5e23d7840ae5
data.publicPlaylists[].isFollowing	boolean	No	false
data.publicPlaylists[].name	string	No	Today’s Top Hits
data.publicPlaylists[].ownerName	string	No	Spotify
data.publicPlaylists[].ownerUri	string	No	spotify:user:spotify
data.publicPlaylists[].ownerUrl	string	No	https://open.spotify.com/user/spotify
data.publicPlaylists[].ownerUsername	string	No	spotify
data.publicPlaylists[].uri	string	No	spotify:playlist:37i9dQZF1DXcBWIGoYBM5M
data.recentlyPlayedArtists	array	No
data.recentlyPlayedArtists[].color	integer	No	16085920
data.recentlyPlayedArtists[].externalUrl	string	No	https://open.spotify.com/user/example
data.recentlyPlayedArtists[].followersCount	integer	No	1000
data.recentlyPlayedArtists[].imageUrl	string	No	https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5
data.recentlyPlayedArtists[].isFollowing	boolean	No	false
data.recentlyPlayedArtists[].name	string	No	Example
data.recentlyPlayedArtists[].uri	string	No	spotify:user:example
data.recentlyPlayedArtists[].username	string	No	example
data.showFollows	boolean	No	true
data.topArtists	spotify.UserProfileTopArtists	No
data.topArtists.imageUrl	string	No	https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5
data.topArtists.subtitle	string	No	Only visible to the user
data.topArtists.title	string	No	Top artists this month
data.topArtists.topArtistsPageUri	string	No	spotify:user:spotify:top:artists
data.totalPublicPlaylistsCount	integer	No	1519
data.uri	string	No	spotify:user:spotify
data.username	string	No	spotify
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/spotify/profile?username=spotify&uri=spotify%3Auser%3Aspotify&url=https%3A%2F%2Fopen.spotify.com%2Fuser%2Fspotify&playlist_limit=10&artist_limit=10&episode_limit=0" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

More Spotify endpoints Spotify platform Pricing Playground

Open in Playground Back to group

Retrieve Spotify public profile

Overview

Request schema

Authentication

Billing

Infrastructure behavior

MCP

Response behavior

Error behavior

Failure responses

Example response

Code examples

Responsible public web data workflows

Related