Browse albums

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

Returns paginated list of all albums.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

pagequeryinteger

limitqueryinteger

sortqueryenum (string)

Allowed valuesplaycountnamerecent

orderqueryenum (string)

Allowed valuesascdesc

artistquerystring

searchquerystring

Response

application/json

Album list

dataarray of objectrequired

paginationobjectrequired

cURL

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

200

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

Browse albums

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

Returns paginated list of all albums.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

pagequeryinteger

limitqueryinteger

sortqueryenum (string)

Allowed valuesplaycountnamerecent

orderqueryenum (string)

Allowed valuesascdesc

artistquerystring

searchquerystring

Response

application/json

Album list

dataarray of objectrequired

paginationobjectrequired

cURL

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

200

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

Authorization

Query Parameters

Response

properties

properties

Authorization

Query Parameters

Response

properties

properties