Watching

Year in review

GET https://api.rewind.rest/v1/watching/year/{year}

Returns aggregate stats and top-rated movies for a specific year.

Authorization

Authorizationheaderstringrequired

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

Path Parameters

yearpathstringrequired

Response

application/json

Year in review data

yearnumberrequired

total_moviesnumberrequired

genresarray of objectrequired

properties

decadesarray of objectrequired

properties

monthlyarray of objectrequired

properties

top_ratedarray of objectrequired

properties

cURL

curl -X GET 'https://api.rewind.rest/v1/watching/year/{year}' \
  -H 'Authorization: Bearer <token>'

200

{
  "year": 0,
  "total_movies": 0,
  "genres": [
    {
      "name": "string",
      "count": 0
    }
  ],
  "decades": [
    {
      "decade": 0,
      "count": 0
    }
  ],
  "monthly": [
    {
      "month": "string",
      "count": 0
    }
  ],
  "top_rated": [
    {
      "movie": {
        "id": "\u2026",
        "title": "\u2026",
        "year": "\u2026",
        "tmdb_id": "\u2026",
        "image": "\u2026"
      },
      "user_rating": 0,
      "watched_at": "string"
    }
  ]
}