Sign in

v1

latestOpenAPI 3.0.32026-07-148993228.8 KB
Player

Get Currently Playing Track

Get the object currently being played on the user's Spotify account.

get/me/player/currently-playing

Query parameters

marketstring

An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.<br/> If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.<br/> Note: If neither market or user country are provided, the content is considered unavailable for the client.<br/> Users can view the country that is associated with their account in the account settings.

Example:ES
additional_typesstring

A comma-separated list of item types that your client supports besides the default track type. Valid types are: track and episode.<br/> Note: This parameter was introduced to allow existing clients to maintain their current behaviour and might be deprecated in the future.<br/> In addition to providing this parameter, make sure that your client properly handles cases of new types in the future by checking against the type field of each object.

Response

Information about the currently playing track

currently_playing_typestring

The object type of the currently playing item. Can be one of track, episode, ad or unknown.

is_playingboolean

If something is currently playing, return true.

progress_msinteger

Progress into the currently playing track or episode. Can be null.

timestampinteger

Unix Millisecond Timestamp when data was fetched

Example response

{
  "item": {
    "album": {
      "album_type": "compilation",
      "available_markets": [
        "CA",
        "BR",
        "IT"
      ],
      "id": "2up3OPMp9Tb4dAKM2erWXQ",
      "images": [
        {
          "height": 300,
          "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
          "width": 300
        }
      ],
      "release_date": "1981-12",
      "release_date_precision": "year",
      "total_tracks": 9,
      "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ",
      "album_group": "compilation"
    },
    "artists": [
      {
        "genres": [
          "Prog rock",
          "Grunge"
        ],
        "images": [
          {
            "height": 300,
            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
            "width": 300
          }
        ]
      }
    ]
  }
}