Watching

Genre breakdown by month

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

Per-month movie-genre buckets for the stacked monthly chart. Each watch is assigned its film’s primary genre (lowest genre id), so counts sum to watch counts. Returns { period (YYYY-MM), genres: {name: count} with the top limit kept and the rest folded into "Other", total }. Supports date filtering.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

limitqueryinteger

datequerystring

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

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

Response

application/json

Genre buckets by month

dataarray of objectrequired

properties

cURL

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

200

{
  "data": [
    {
      "period": "string",
      "genres": {},
      "total": 0
    }
  ]
}