Skip to main content
GET
/
v1
/
watching
/
stats
Watch stats
curl --request GET \
  --url https://api.rewind.rest/v1/watching/stats \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "total_movies": 773,
    "total_watch_time_hours": 1507,
    "movies_this_year": 27,
    "avg_per_month": 8.1,
    "top_genre": "Drama",
    "top_decade": 2000,
    "top_director": "Martin Scorsese",
    "total_shows": 98,
    "total_episodes_watched": 1572,
    "episodes_this_year": 106
  }
}

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.

Query Parameters

​
date
string

Single day (YYYY-MM-DD). Overrides from/to.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2025-02-17"

​
from
string

Range start, inclusive (ISO 8601)

Example:

"2025-02-01T00:00:00Z"

​
to
string

Range end, inclusive (ISO 8601)

Example:

"2025-02-28T23:59:59Z"

Response

Watch stats

​
data
object
required