MyAnimeList anime operations ​

MyAnimeListAnimeApi.get gets one anime by its MyAnimeList ID through MalAnimeOperation.get. It is the public facade for the GET /anime/{id} endpoint; use MalRequestOptions.fields to select the response shape and MalRequestOptions transport settings to override per call.

get(params: MalAnimeGetParams, options?: MalRequestOptions): Promise<MalAnime>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const anime = await api.anime.get({ id: 21 }, { fields: ["id", "title", "main_picture"] });

MyAnimeListAnimeApi.search searches MyAnimeList anime by keyword through MalAnimeOperation.search. It is the public facade for GET /anime; use MalRequestOptions.fields to select the response shape and MalRequestOptions transport settings to override per call.

search(params: MalAnimeSearchParams, options?: MalRequestOptions): Promise<MalAnimeSearchResponse>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const results = await api.anime.search(
  { q: "one piece" },
  { fields: ["id", "title", "main_picture"] }
);
console.log(results.data[0]?.node.title);

MyAnimeListAnimeApi.seasonal gets the anime of one broadcast season through MalAnimeOperation.seasonal. It is the public facade for GET /anime/season/{year}/{season}; use MalRequestOptions.fields to select the response shape and MalRequestOptions transport settings to override per call.

seasonal(params: MalSeasonalParams, options?: MalRequestOptions): Promise<MalSeasonalAnimeResponse>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const season = await api.anime.seasonal(
  { year: 2024, season: "winter" },
  { fields: ["id", "title", "main_picture"] }
);
console.log(season.data[0]?.node.title);

MyAnimeListAnimeApi.ranking gets one of MyAnimeList's anime ranking lists through MalAnimeOperation.ranking. It is the public facade for GET /anime/ranking; use MalRequestOptions.fields to select the response shape and MalRequestOptions transport settings to override per call.

ranking(params: MalRankingParams, options?: MalRequestOptions): Promise<MalAnimeRankingResponse>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const top = await api.anime.ranking(
  { rankingType: "airing" },
  { fields: ["id", "title", "mean"] }
);
console.log(top.data[0]?.node.title, top.data[0]?.ranking.rank);

MyAnimeListAnimeApi.suggestions gets MyAnimeList's anime suggestions for the authenticated user through MalAnimeOperation.suggestions. It is the public facade for GET /anime/suggestions and requires a MAL access token from MalCredentials.accessToken via buildMyAnimeListApi; use MalRequestOptions.fields to select the response shape.

suggestions(options?: MalRequestOptions): Promise<MalAnimeSuggestionsResponse>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const suggestions = await api.anime.suggestions({
  fields: ["id", "title", "main_picture"],
});
console.log(suggestions.data[0]?.node.title);

MyAnimeListAnimeApi.updateMyListStatus updates the authenticated user's anime list status through MalAnimeOperation.updateMyListStatus. It is the public facade for PATCH /anime/{id}/my_list_status and requires a MAL access token from MalCredentials.accessToken via buildMyAnimeListApi; send only the MalAnimeListStatusUpdate fields you want to change, form-encoded as MAL requires.

updateMyListStatus(params: MalAnimeListStatusUpdateParams, options?: MalRequestOptions): Promise<MalAnimeListStatus>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const status = await api.anime.updateMyListStatus({
  id: 21,
  status: "watching",
  num_watched_episodes: 10,
  score: 9,
});

MyAnimeListAnimeApi.deleteFromList removes an anime from the authenticated user's list through MalAnimeOperation.deleteFromList. It is the public facade for DELETE /anime/{id}/my_list_status and requires a MAL access token from MalCredentials.accessToken via buildMyAnimeListApi.

deleteFromList(params: MalAnimeDeleteParams, options?: MalRequestOptions): Promise<void>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
await api.anime.deleteFromList({ id: 21 });