FIREANIME API
Browse API97 operations
POST

GetUserAnimeWatchStats

GetUserAnimeWatchStats retrieves heatmap data representing the user's watch activity over time.

/api.v1.user.UserService/GetUserAnimeWatchStats Bearer required
01

Request

GetUserAnimeWatchStatsRequest

GetUserAnimeWatchStatsRequestapi.v1.user.GetUserAnimeWatchStatsRequest1 fields

GetUserAnimeWatchStatsRequest specifies the target user for watch activity statistics.

userIdoptional
uint32

Optional user ID. If omitted, refers to the authenticated user.

Request JSON
{
  "userId": 1
}
02

Response

GetUserAnimeWatchStatsResponse

GetUserAnimeWatchStatsResponseapi.v1.user.GetUserAnimeWatchStatsResponse1 fields

GetUserAnimeWatchStatsResponse contains a collection of watch activity data points.

dataarray
GetUserAnimeWatchStatsPoint[]

A list of daily watch activity counts.

Example response
{
  "data": [
    {
      "date": "2026-08-19T20:15:00Z",
      "count": 1
    }
  ]
}
03

Referenced models

1 nested message types

GetUserAnimeWatchStatsPointapi.v1.user.GetUserAnimeWatchStatsPoint2 fields

GetUserAnimeWatchStatsPoint represents a single data point in a watch activity heatmap.

date
string

The date of the watch activity (e.g., "YYYY-MM-DD").

count
int32

The count of episodes watched on this specific date.

04

Error handling

Common failure codes

unauthenticatedThe Bearer token is missing or invalid.

invalid_argumentThe request payload failed validation.

internalThe service could not complete the operation.