Sign in

v1

latestOpenAPI 3.0.32026-07-148993228.8 KB
Player

Get Recently Played Tracks

Get tracks from the current user's recently played tracks. Note: Currently doesn't support podcast episodes.

get/me/player/recently-played

Query parameters

limitinteger

The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

Example:10
afterinteger

A Unix timestamp in milliseconds. Returns all items after (but not including) this cursor position. If after is specified, before must not be specified.

Example:1484811043508
beforeinteger

A Unix timestamp in milliseconds. Returns all items before (but not including) this cursor position. If before is specified, after must not be specified.

Response

A paged set of tracks

hrefstring

A link to the Web API endpoint returning the full result of the request.

limitinteger

The maximum number of items in the response (as set in the query or by default).

nextstring

URL to the next page of items. ( null if none)

totalinteger

The total number of items available to return.

Example response

{
  "items": [
    {
      "track": {
        "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
              }
            ]
          }
        ]
      }
    }
  ]
}