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"
}
]
}Returns aggregate stats and top-rated movies for a specific year.
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.
API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.