---
title: "Retrieve Spotify public profile"
method: GET
path: "/spotify/profile"
tags: ["Spotify"]
---

# Retrieve Spotify public 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`

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

## Query parameters

- `username` string
- `uri` string
- `url` string
- `playlist_limit` integer
- `artist_limit` integer
- `episode_limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyUserProfileResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyUserProfileResponse
    - `allowFollows` boolean: Whether the profile allows other users to follow it.
    - `color` integer: Accent color of the profile, as a number.
    - `externalUrl` string: Link to the user's profile on open.spotify.com.
    - `followersCount` integer: Number of followers the user has.
    - `followingCount` integer: Number of accounts the user follows.
    - `hasSpotifyImage` boolean: Whether the profile has an image set on Spotify.
    - `hasSpotifyName` boolean: Whether the profile has a display name set on Spotify.
    - `imageUrl` string: URL of the user's profile image.
    - `isCurrentUser` boolean: Whether Spotify marks the profile as the current user's own.
    - `isVerified` boolean: Whether Spotify shows the profile as verified.
    - `meta` SpotifyUserProfileMeta
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `artistCount` integer: Number of recently played artists returned.
      - `fetchedAt` string: Time the data was fetched, in UTC (RFC 3339).
      - `operationName` string: Name of the Spotify web player operation that returned the data.
      - `playlistCount` integer: Number of playlists returned.
      - `profileCount` integer: Number of user profiles returned.
    - `name` string: Display name of the user.
    - `publicPlaylists` SpotifyUserProfilePlaylist[]: Public playlists of the user.
      - `externalUrl` string: Link to the playlist on open.spotify.com.
      - `followersCount` integer: Number of followers the playlist has.
      - `id` string: Spotify ID of the playlist.
      - `imageUrl` string: URL of the playlist cover image.
      - `isFollowing` boolean: Whether Spotify marks the playlist as followed.
      - `name` string: Playlist title as Spotify shows it.
      - `ownerName` string: Display name of the playlist owner.
      - `ownerUri` string: Spotify URI of the playlist owner.
      - `ownerUrl` string: Link to the playlist owner's profile on open.spotify.com.
      - `ownerUsername` string: Spotify username of the playlist owner.
      - `uri` string: Spotify URI of the playlist.
    - `recentlyPlayedArtists` SpotifyUserProfileSummary[]: Artists the user played recently.
      - `color` integer: Accent color of the profile, as a number.
      - `externalUrl` string: Link to the user's profile on open.spotify.com.
      - `followersCount` integer: Number of followers the user has.
      - `imageUrl` string: URL of the user's profile image.
      - `isFollowing` boolean: Whether Spotify marks the user as followed.
      - `name` string: Display name of the user.
      - `uri` string: Spotify URI of the user.
      - `username` string: Spotify username of the user.
    - `showFollows` boolean: Whether Spotify shows the profile's follows publicly.
    - `topArtists` SpotifyUserProfileTopArtists
      - `imageUrl` string: URL of the image shown for the section.
      - `subtitle` string: Secondary line shown under the section heading.
      - `title` string: Heading of the top artists section, as Spotify shows it.
      - `topArtistsPageUri` string: Spotify URI of the page that lists the user's top artists.
    - `totalPublicPlaylistsCount` integer: Total number of public playlists the user has.
    - `uri` string: Spotify URI of the user.
    - `username` string: Spotify username of the user.
  - `msg` unknown

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `503`: Spotify upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)