Skip to content
DocumentationAPI Reference

Get User's Profile

UserRetrieveProfileResponse Users.RetrieveProfile(UserRetrieveProfileParamsparameters, CancellationTokencancellationToken = default)
GET/users/{user_id}

Get public profile information about a Spotify user.

ParametersExpand Collapse
UserRetrieveProfileParams parameters
required string userID

The user's Spotify user ID.

ReturnsExpand Collapse
class UserRetrieveProfileResponse:
string ID

The Spotify user ID for this user.

string? DisplayName

The name displayed on the user's profile. null if not available.

ExternalUrlObject ExternalUrls

Known public external URLs for this user.

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

string Spotify

The Spotify URL for the object.

FollowersObject Followers

Information about the followers of this user.

string? Href

This will always be set to null, as the Web API does not support it at the moment.

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Long Total

The total number of followers.

string Href

A link to the Web API endpoint for this user.

IReadOnlyList<ImageObject> Images

The user's profile image.

required Long? Height

The image height in pixels.

required string Url

The source URL of the image.

required Long? Width

The image width in pixels.

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Type Type

The object type.

string Uri

The Spotify URI for this user.

Get User's Profile

UserRetrieveProfileParams parameters = new() { UserID = "smedjan" };

var response = await client.Users.RetrieveProfile(parameters);

Console.WriteLine(response);
{
  "id": "id",
  "display_name": "display_name",
  "external_urls": {
    "published": true,
    "spotify": "spotify"
  },
  "followers": {
    "href": "href",
    "published": true,
    "total": 0
  },
  "href": "href",
  "images": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "published": true,
  "type": "user",
  "uri": "uri"
}
Returns Examples
{
  "id": "id",
  "display_name": "display_name",
  "external_urls": {
    "published": true,
    "spotify": "spotify"
  },
  "followers": {
    "href": "href",
    "published": true,
    "total": 0
  },
  "href": "href",
  "images": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "published": true,
  "type": "user",
  "uri": "uri"
}