FIREANIME API
Browse API97 operations
POST

ListEpisodesLiked

ListEpisodesLiked retrieves a paginated list of all episodes the user has liked.

/api.v1.watch.WatchService/ListEpisodesLiked Bearer required
01

Request

ListEpisodesLikedRequest

ListEpisodesLikedRequestapi.v1.watch.ListEpisodesLikedRequest1 fields

ListEpisodesLikedRequest specifies pagination for the liked list.

page
int32

The page number to retrieve (1-based).

Request JSON
{
  "page": 1
}
02

Response

ListEpisodesLikedResponse

ListEpisodesLikedResponseapi.v1.watch.ListEpisodesLikedResponse2 fields

ListEpisodesLikedResponse contains a page of liked episodes.

dataarray
EpisodeLiked[]

Collection of liked episode metadata.

max
int32

The total number of liked episodes.

Example response
{
  "data": [
    {
      "id": 1,
      "createdAt": "2026-08-19T20:15:00Z",
      "updatedAt": "1",
      "slug": "frieren",
      "season": "1",
      "episode": "1",
      "isLiked": true,
      "userId": 1
    }
  ],
  "max": 1
}
03

Referenced models

1 nested message types

EpisodeLikedapi.v1.watch.EpisodeLiked14 fields

EpisodeLiked represents a user's positive reaction to an episode.

id
uint32

Unique database identifier for the like record.

createdAt
string

Timestamp when the like was first recorded (RFC3339 format).

updatedAt
int64

Unix timestamp (milliseconds) of the last update.

slug
string

URL-friendly identifier for the anime.

season
string

Season identifier.

episode
string

Episode identifier.

isLiked
bool

If true, represents a like; if false, represents no reaction (or potentially a dislike in other contexts).

userId
uint32

The ID of the user who performed the action.

animeIdoptional
uint32

Enriched field: The database ID of the associated anime.

titleoptional
string

Enriched field: The public title of the anime.

startoptional
int32

Enriched field: Start timestamp (e.g., for season range).

endoptional
int32

Enriched field: End timestamp.

posteroptional
string

Enriched field: URL to the anime's poster.

backdropoptional
string

Enriched field: URL to the anime's backdrop.

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.