Get Current User's Profile

GET

/me

category-users-profile

Get detailed profile information about the current user (including the
current user's username).

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/me' \
--header 'Authorization;'

响应示例

200 - 示例 1

{
  "country": "string",
  "display_name": "string",
  "email": "string",
  "explicit_content": {
    "filter_enabled": true,
    "filter_locked": true
  },
  "external_urls": {
    "spotify": "string"
  },
  "followers": {
    "href": "string",
    "total": 0
  },
  "href": "string",
  "id": "string",
  "images": [
    {
      "height": 0,
      "url": "string",
      "width": 0
    }
  ],
  "product": "string",
  "type": "string",
  "uri": "string"
}

请求参数

Header 参数

Authorization

必需

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the current user.
Reading the user's email address requires the user-read-email scope; reading country, product subscription level and explicit content settings requires the user-read-private scope. See Using Scopes.

返回响应

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains a [user object](https://developer.spotify.com/documentation/web-api/reference/#object-privateuserobject) in JSON format. On error, the header status code is

application/json

Body

country

string

可选

The country of the user, as set in the user's account profile. An ISO 3166-1 alpha-2 country code. This field is only available when the current user has granted access to the user-read-private scope.

display_name

string

可选

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

string

可选

The user's email address, as entered by the user when creating their account. Important! This email address is unverified; there is no proof that it actually belongs to the user. This field is only available when the current user has granted access to the user-read-email scope.

explicit_content

object (ExplicitContentSettingsObject)

可选

filter_enabled

boolean

可选

When true, indicates that explicit content should not be played.

filter_locked

boolean

可选

When true, indicates that the explicit content setting is locked and can't be changed by the user.

external_urls

object (ExternalUrlObject)

可选

spotify

string

可选

The Spotify URL for the object.

followers

object (FollowersObject)

可选

href

string

可选

A link to the Web API endpoint providing full details of the followers; null if not available. Please note that this will always be set to null, as the Web API does not support it at the moment.

total

integer <int32>

可选

The total number of followers.

href

string

可选

A link to the Web API endpoint for this user.

string

可选

The Spotify user ID for the user.

images

array[object (ImageObject) {3}]

可选

The user's profile image.

height

integer <int32>

可选

The image height in pixels. If unknown: null or not returned.

url

string

可选

The source URL of the image.

width

integer <int32>

可选

The image width in pixels. If unknown: null or not returned.

product

string

可选

The user's Spotify subscription level: "premium", "free", etc. (The subscription level "open" can be considered the same as "free".) This field is only available when the current user has granted access to the user-read-private scope.

type

string

可选

The object type: "user"

uri

string

可选

The Spotify URI for the user.

🔴500500

Get Available Markets

Get a User's Profile