FIREANIME API
Browse API97 operations
POST

GetEpisodeLiked

GetEpisodeLiked retrieves the current user's reaction (like status) for a specific episode.

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

Request

GetEpisodeLikedRequest

GetEpisodeLikedRequestapi.v1.watch.GetEpisodeLikedRequest3 fields

GetEpisodeLikedRequest identifies the episode to check.

slug
string

URL-friendly identifier for the anime.

season
string

Season identifier.

episode
string

Episode identifier.

Request JSON
{
  "slug": "frieren",
  "season": "1",
  "episode": "1"
}
02

Response

GetEpisodeLikedResponse

GetEpisodeLikedResponseapi.v1.watch.GetEpisodeLikedResponse1 fields

GetEpisodeLikedResponse contains the user's reaction metadata.

data
EpisodeLiked

The reaction record (may be empty if no reaction exists).

Example response
{
  "data": {
    "id": 1,
    "createdAt": "2026-08-19T20:15:00Z",
    "updatedAt": "1",
    "slug": "frieren",
    "season": "1",
    "episode": "1",
    "isLiked": true,
    "userId": 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.