Skip to main content
GET
/
v1
/
watching
/
year
/
{year}
Year in review
curl --request GET \
  --url https://api.rewind.rest/v1/watching/year/{year} \
  --header 'Authorization: Bearer <token>'
{
  "year": 2025,
  "total_movies": 95,
  "genres": [
    {
      "name": "Drama",
      "count": 35
    },
    {
      "name": "Action",
      "count": 20
    }
  ],
  "decades": [
    {
      "decade": 2020,
      "count": 30
    },
    {
      "decade": 1960,
      "count": 8
    }
  ],
  "monthly": [
    {
      "month": "2025-01",
      "count": 8
    },
    {
      "month": "2025-02",
      "count": 10
    },
    {
      "month": "2025-03",
      "count": 9
    }
  ],
  "top_rated": [
    {
      "movie": {
        "id": 50,
        "title": "The Great Escape",
        "year": 1963,
        "tmdb_id": 5925,
        "image": null
      },
      "user_rating": 5,
      "watched_at": "2025-08-10T20:00:00Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Path Parameters

year
string
required

Response

Year in review data

year
number
required
total_movies
number
required
genres
object[]
required
decades
object[]
required
monthly
object[]
required
top_rated
object[]
required