Spotify Web API

Get Current User's Recently Played Tracks

GET

/me/player/recently-played

category-player

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 示例 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
}

请求参数

Query 参数

limit

可选

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

after

可选

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

可选

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 参数

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

返回响应

🟢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)

可选

after

string

可选

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

href

string

可选

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

items

array[object (PlayHistoryObject) {3}]

可选

The requested data.

context

object (ContextObject)

可选

played_at

string <date-time>

可选

The date and time the track was played.

track

object (SimplifiedTrackObject)

可选

limit

integer <int32>

可选

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

string

可选

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

total

integer <int32>

可选

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

Add an item to queue

Set Repeat Mode On User’s Playback