Spotify Web API

Get Current User's Recently Played Tracks

Developing

GET

/me/player/recently-played

category-player

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

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
  "cursors": {
    "after": "string"
  },
  "href": "string",
  "items": [
    {
      "context": {
        "external_urls": {
          "spotify": "string"
        },
        "href": "string",
        "type": "string",
        "uri": "string"
      },
      "played_at": "2019-08-24T14:15:22Z",
      "track": {
        "artists": [
          {
            "external_urls": {
              "spotify": "string"
            },
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          "string"
        ],
        "disc_number": 0,
        "duration_ms": 0,
        "explicit": true,
        "external_urls": {
          "spotify": "string"
        },
        "href": "string",
        "id": "string",
        "is_local": true,
        "is_playable": true,
        "linked_from": {
          "external_urls": {
            "spotify": "string"
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "restrictions": {
          "reason": "string"
        },
        "track_number": 0,
        "type": "string",
        "uri": "string"
      }
    }
  ],
  "limit": 0,
  "next": "string",
  "total": 0
}

Request

Query Params

limit

integer

optional

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

after

integer

optional

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

before

integer

optional

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

Header Params

Authorization

string

required

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 a user.

Responses

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains an array of [play history objects](#play-history-object) (wrapped in a [cursor-based paging object](#cursor-based-paging-object)) in JSON format. The play h

application/json

Body

cursors

object (CursorObject)

optional

after

string

optional

The cursor to use as key to find the next page of items.

href

string

optional

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

items

array[object (PlayHistoryObject) {3}]

optional

The requested data.

context

object (ContextObject)

optional

played_at

string <date-time>

optional

The date and time the track was played.

track

object (SimplifiedTrackObject)

optional

limit

integer <int32>

optional

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

string

optional

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

total

integer <int32>

optional

The total number of items available to return.

🟢204On success, the HTTP status code in the response header is `200` OK and the response body contains an array of [play history objects](#play-history-object) (wrapped in a [cursor-based paging object](#cursor-based-paging-object)) in JSON format. The play h

🔴500500

Modified at 2022-09-12 10:04:50

Add an item to queue

Set Repeat Mode On User’s Playback