Spotify

Retrieve Spotify public profile

Returns public Spotify profile metadata and preview playlists. Provide username, uri, or url; defaults to Spotify's official profile.

get/spotify/profile

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/spotify/profile
  • Auth: API key in header x-api-key

Query parameters

usernamestring

Spotify username

uristring

Spotify user URI

urlstring

open.spotify.com user URL

playlist_limitinteger

Embedded public playlist limit, clamped to 0-50

artist_limitinteger

Recently played artist limit, clamped to 0-50

episode_limitinteger

Embedded episode limit, clamped to 0-50

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "allowFollows": true,
    "color": 16085920,
    "externalUrl": "https://open.spotify.com/user/spotify",
    "followersCount": 12162371,
    "followingCount": 327,
    "hasSpotifyImage": true,
    "hasSpotifyName": true,
    "imageUrl": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
    "isVerified": true,
    "meta": {
      "appVersion": "1.2.90.403.gf901f20f",
      "fetchedAt": "2026-05-13T20:41:12Z",
      "operationName": "userProfileView",
      "playlistCount": 10,
      "profileCount": 50
    },
    "name": "Spotify",
    "publicPlaylists": [
      {
        "externalUrl": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
        "followersCount": 34324513,
        "id": "37i9dQZF1DXcBWIGoYBM5M",
        "imageUrl": "https://i.scdn.co/image/ab67706f0000000273f7bb6e77ec5e23d7840ae5",
        "name": "Today’s Top Hits",
        "ownerName": "Spotify",
        "ownerUri": "spotify:user:spotify",
        "ownerUrl": "https://open.spotify.com/user/spotify",
        "ownerUsername": "spotify",
        "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M"
      }
    ],
    "recentlyPlayedArtists": [
      {
        "color": 16085920,
        "externalUrl": "https://open.spotify.com/user/example",
        "followersCount": 1000,
        "imageUrl": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
        "name": "Example",
        "uri": "spotify:user:example",
        "username": "example"
      }
    ],
    "showFollows": true,
    "topArtists": {
      "imageUrl": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
      "subtitle": "Only visible to the user",
      "title": "Top artists this month",
      "topArtistsPageUri": "spotify:user:spotify:top:artists"
    },
    "totalPublicPlaylistsCount": 1519,
    "uri": "spotify:user:spotify",
    "username": "spotify"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.