Skip to main content
Rewind is a hosted API, so there is nothing to install or run. With an API key you can make your first call in a couple of minutes.
You need a Rewind API key (rw_live_...). See Authentication to create one and for the read-versus-admin key types.
1

Check the API is up

The health endpoint needs no authentication, so it is the simplest way to confirm you can reach the API.
curl https://api.rewind.rest/v1/health

{ "status": "ok", "timestamp": "2026-03-18T21:00:00.000Z" }
2

Make your first authenticated call

Every other endpoint takes your key as a Bearer token in the Authorization header. Fetch your most recent scrobbles:
curl -H "Authorization: Bearer rw_live_..." \
  "https://api.rewind.rest/v1/listening/recent?limit=5"

{
  "data": [
    {
      "track": { "id": 4296, "name": "Cherry" },
      "artist": { "id": 551, "name": "Ratatat" },
      "album": { "id": 1566, "name": "Ratatat" },
      "scrobbled_at": "2026-03-18T01:14:04.000Z"
    }
  ]
}
3

Try another domain

Every domain answers on the same /v1/<domain>/... shape. Pull your lifetime running stats:
curl -H "Authorization: Bearer rw_live_..." \
  https://api.rewind.rest/v1/running/stats

{
  "data": {
    "total_runs": 1350,
    "total_distance_mi": 6069.88,
    "avg_pace": "8:12/mi",
    "years_active": 17
  }
}
4

Page and filter results

List endpoints return a { data, pagination } envelope and accept page and limit. Most list and stats endpoints also accept date, from, and to filters.
curl -H "Authorization: Bearer rw_live_..." \
  "https://api.rewind.rest/v1/listening/recent?from=2026-01-01&limit=10"
From here, browse the full OpenAPI spec to generate a client, or use Rewind from Claude through the MCP server.