Listening

Browse artists

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

Returns paginated list of all artists.

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 valuesplaycountname

orderqueryenum (string)

Allowed valuesascdesc

searchquerystring

Response

application/json

Artist list

dataarray of objectrequired

properties

paginationobjectrequired

properties

cURL

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

200

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