Year in review

curl --request GET \
  --url https://api.rewind.rest/v1/listening/year/{year} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.rewind.rest/v1/listening/year/{year}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.rewind.rest/v1/listening/year/{year}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "year": 2025,
  "total_scrobbles": 8500,
  "unique_artists": 420,
  "unique_albums": 890,
  "unique_tracks": 3200,
  "top_artists": [
    {
      "id": 92,
      "name": "Taylor Swift",
      "scrobbles": 350,
      "apple_music_url": "https://music.apple.com/us/artist/taylor-swift/159260351?uo=4",
      "image": null
    },
    {
      "id": 189,
      "name": "Nirvana",
      "scrobbles": 280,
      "apple_music_url": "https://music.apple.com/us/artist/nirvana/112018?uo=4",
      "image": null
    }
  ],
  "top_albums": [
    {
      "id": 20,
      "name": "GUTS",
      "artist": "Olivia Rodrigo",
      "scrobbles": 120,
      "apple_music_url": null,
      "image": null
    },
    {
      "id": 300,
      "name": "MTV Unplugged in New York",
      "artist": "Nirvana",
      "scrobbles": 95,
      "apple_music_url": null,
      "image": null
    }
  ],
  "top_tracks": [
    {
      "id": 2001,
      "name": "Espresso",
      "artist": "Sabrina Carpenter",
      "scrobbles": 68,
      "apple_music_url": null,
      "preview_url": null
    },
    {
      "id": 1001,
      "name": "bad idea right?",
      "artist": "Olivia Rodrigo",
      "scrobbles": 55,
      "apple_music_url": null,
      "preview_url": null
    }
  ],
  "monthly": [
    {
      "month": "2025-01",
      "scrobbles": 720,
      "unique_artists": 85,
      "unique_albums": 140
    },
    {
      "month": "2025-02",
      "scrobbles": 680,
      "unique_artists": 78,
      "unique_albums": 125
    }
  ]
}

{
  "error": "Not found",
  "status": 404
}

{
  "error": "Not found",
  "status": 404
}