Listening

Listening history

GET https://api.rewind.rest/v1/listening/history

Returns paginated scrobble history with optional filters.

Authorization

Authorizationheaderstringrequired

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

pagequeryinteger

limitqueryinteger

fromquerystring

toquerystring

artistquerystring

albumquerystring

Response

application/json

Scrobble history

dataarray of objectrequired

properties

paginationobjectrequired

properties

cURL

curl -X GET 'https://api.rewind.rest/v1/listening/history' \
  -H 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "track": {
        "id": "\u2026",
        "name": "\u2026",
        "url": "\u2026",
        "apple_music_url": "\u2026",
        "preview_url": "\u2026"
      },
      "artist": {
        "id": "\u2026",
        "name": "\u2026"
      },
      "album": {
        "id": "\u2026",
        "name": "\u2026",
        "image": "\u2026"
      },
      "scrobbled_at": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8
  }
}