FIREANIME API
Browse API97 operations
POST

GetNextEpisodes

GetNextEpisodes returns a list of episodes the user might want to watch next based on their history.

/api.v1.anime.AnimeService/GetNextEpisodes Bearer required
01

Request

GetNextEpisodesRequest

GetNextEpisodesRequestapi.v1.anime.GetNextEpisodesRequest2 fields

GetNextEpisodesRequest specifies continue-watching options.

limit
int32

Maximum number of items to return. Defaults to 50 and is capped at 100.

includeCompleted
bool

If true, completed final episodes may be included.

Request JSON
{
  "limit": 20,
  "includeCompleted": false
}
02

Response

GetNextEpisodesResponse

GetNextEpisodesResponseapi.v1.anime.GetNextEpisodesResponse2 fields

GetNextEpisodesResponse contains a list of recommended next episodes.

dataarray
NextEpisodeItem[]

The collection of recommended episodes.

status
int32

HTTP-style status code for the response.

Example response
{
  "data": [
    {
      "slug": "frieren",
      "season": "1",
      "episode": "1",
      "title": "Frieren: Beyond Journey’s End",
      "poster": "https://example.com/image.webp",
      "backdrop": "https://example.com/image.webp",
      "lastSeen": 1,
      "watchStatus": "active"
    }
  ],
  "status": 200
}
03

Referenced models

1 nested message types

NextEpisodeItemapi.v1.anime.NextEpisodeItem17 fields

NextEpisodeItem represents an episode recommended for the user's next viewing.

slug
string

URL-friendly identifier for the anime.

season
string

Season identifier.

episode
string

Episode identifier.

title
string

Title of the anime.

poster
string

URL to the anime's poster image.

backdrop
string

URL to the anime's backdrop image.

lastSeen
int32

Unix timestamp of when the user last watched this anime.

watchStatus
string

Current watch status (e.g., "watching", "completed").

position
int32

Optional position or order.

animeGroupIdoptional
uint32

Optional anime group context used to route back to grouped watch pages.

groupTitle
string

Human-readable anime group title.

positionSeconds
int32

Current saved playback position in seconds.

positionMax
int32

Total saved playback duration in seconds.

isCompleted
bool

If true, the source episode is complete.

isResume
bool

If true, this item resumes the source episode instead of opening a next episode.

sourceSeason
string

Source season that produced this recommendation.

sourceEpisode
string

Source episode that produced this recommendation.

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.