GetAnime | Anime API

Request

GetAnimeRequest

GetAnimeRequestapi.v1.anime.GetAnimeRequest2 fields

GetAnimeRequest specifies the anime to retrieve by its slug or numeric ID.

slugoptional

string

URL-friendly identifier for the anime.

idoptional

uint32

Unique database identifier for the anime.

Request JSON

{
  "slug": "frieren",
  "id": 1
}

Response

GetAnimeResponse

GetAnimeResponseapi.v1.anime.GetAnimeResponse2 fields

GetAnimeResponse contains the full metadata for a single anime.

data

Anime

The retrieved anime metadata.

status

int32

HTTP-style status code for the response.

Example response

{
  "data": {
    "id": 1,
    "slug": "frieren",
    "title": "Frieren: Beyond Journey’s End",
    "alternateTitles": "Frieren: Beyond Journey’s End",
    "generes": [
      "string value"
    ],
    "imdb": "string value",
    "tmdb": 1,
    "desc": "Example content"
  },
  "status": 200
}

Referenced models

6 nested message types

Animeapi.v1.models.Anime21 fields

Anime represents the high-level metadata for an anime series or movie.

id

uint32

Unique database identifier for the anime.

slug

string

URL-friendly identifier for the anime (e.g., "cowboy-bebop").

title

string

The primary title of the anime.

alternateTitles

string

A string containing alternative titles (comma-separated or JSON).

generesarray

string[]

A list of genre names associated with the anime.

imdboptional

string

Optional IMDb identifier.

tmdboptional

int32

Optional TMDB identifier.

descoptional

string

A long-form description or synopsis of the anime.

startoptional

int32

The year the anime started airing.

endoptional

int32

The year the anime finished airing.

poster

string

URL to the anime's primary poster image.

voteAvgoptional

float

Average user rating (e.g., 0.0 to 10.0).

voteCountoptional

int32

Total number of user ratings received.

tmdbType

string

TMDB content type (e.g., "tv", "movie").

anilistoptional

int32

Optional Anilist identifier.

backdrop

string

URL to the anime's horizontal backdrop image.

itemType

string

High-level item type (e.g., "anime", "hentai").

animeSeasonsarray

AnimeSeason[]

Relations: Collection of seasons associated with this anime.

animeGroupsarray

AnimeGroup[]

Relations: Collection of grouping metadata (e.g., for Anilist mapping).

trailerSite

string

Trailer provider. Currently "youtube" when a preview is available.

trailerId

string

Provider-specific trailer identifier. This is not an arbitrary URL.

AnimeSeasonapi.v1.models.AnimeSeason3 fields

AnimeSeason represents a specific season or category of episodes for an anime.

id

uint32

Unique database identifier for the season.

season

string

The season identifier (e.g., "1", "2", "OVA").

animeEpisodesarray

AnimeEpisode[]

Collection of episodes belonging to this season.

AnimeEpisodeapi.v1.models.AnimeEpisode6 fields

AnimeEpisode represents a single episode within an anime season.

id

uint32

Unique database identifier for the episode.

episode

string

The episode identifier (e.g., "1", "12").

imageoptional

string

URL to an episode-specific thumbnail or image.

animeSeasonId

uint32

The ID of the parent season.

animeEpisodeLinksarray

AnimeEpisodeLink[]

Collection of streaming hoster links for this episode.

episodeNoticeoptional

string

Optional notice message to display instead of the player (e.g., during takedowns).

AnimeEpisodeLinkapi.v1.models.AnimeEpisodeLink4 fields

AnimeEpisodeLink represents a specific streaming hoster URL for an episode.

id

uint32

Unique database identifier for the link.

link

string

The raw URL to the streaming hoster or file.

lang

string

The language identifier for the link (e.g., "ger-dub", "eng-sub").

name

string

Human-readable name of the hoster (e.g., "Voe", "DoodStream").

AnimeGroupapi.v1.models.AnimeGroup21 fields

AnimeGroup represents a mapping layer between the local database and Anilist.

id

uint32

Unique database identifier for the group record.

animeId

uint32

The ID of the local anime being grouped.

anilistId

int32

The associated Anilist media identifier.

slug

string

URL-friendly identifier for the group (usually matches the anime slug).

title

string

Primary title.

romajiTitle

string

Title in Romaji script.

nativeTitle

string

Title in native script (Japanese).

desc

string

Description or synopsis from Anilist.

cover

string

URL to the cover image from Anilist.

startDate

string

Start date of the group content (YYYY-MM-DD).

endDate

string

End date of the group content (YYYY-MM-DD).

status

string

Airing status from Anilist (e.g., "FINISHED", "RELEASING").

episodes

int32

Total number of episodes in this group.

format

string

Release format (e.g., "TV", "MOVIE", "OVA").

season

string

Season name (e.g., "SPRING", "SUMMER").

year

int32

Release year.

generesarray

string[]

List of genres from Anilist.

tagsarray

string[]

List of descriptive tags from Anilist.

prequelIdoptional

uint32

Optional ID of the preceding anime group.

sequelIdoptional

uint32

Optional ID of the succeeding anime group.

animeGroupEpisodesarray

AnimeGroupEpisode[]

Relations: Collection of local episodes mapped to this Anilist group.

AnimeGroupEpisodeapi.v1.models.AnimeGroupEpisode5 fields

AnimeGroupEpisode maps a specific local episode to an Anilist group with ordering.

id

uint32

Unique database identifier for the mapping.

animeGroupId

uint32

ID of the parent anime group.

animeEpisodeId

uint32

ID of the local anime episode.

order

int32

The display order or absolute episode number within the group.

animeEpisodeoptional

AnimeEpisode

Enriched field: The full local episode metadata.

Error handling

Common failure codes

invalid_argumentThe request payload failed validation.

internalThe service could not complete the operation.

Request example

curl 'https://fireani.me/api.v1.anime.AnimeService/GetAnime' \
  -X POST \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "slug": "frieren",
  "id": 1
}'