Watching

Watch stats

GET https://api.rewind.rest/v1/watching/stats

Returns aggregate watching statistics. Supports optional date filtering to scope stats to a time period.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

datequerystring

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

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

Response

application/json

Watch stats

dataobjectrequired

properties

cURL

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

200

{
  "data": {
    "total_movies": 0,
    "total_watch_time_hours": 0,
    "movies_this_year": 0,
    "avg_per_month": 0,
    "top_genre": "string",
    "top_decade": 0,
    "top_director": "string",
    "total_shows": 0,
    "total_episodes_watched": 0,
    "episodes_this_year": 0
  }
}