MyAnimeList user operations ​

MyAnimeListUserApi.me gets the currently authenticated MyAnimeList user through MalUserOperation.me. It is the public facade for GET /users/@me and requires a MAL access token from MalCredentials.accessToken via buildMyAnimeListApi; use MalRequestOptions.fields to select the response shape.

me(options?: MalRequestOptions): Promise<MalUser>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const user = await api.user.me({ fields: ["id", "name"] });

MyAnimeListUserApi.get gets a MyAnimeList user profile through MalUserOperation.get. It is the public facade for GET /users/{user_name}. MyAnimeList documents only @me for this endpoint. Other usernames are passed through, but MyAnimeList currently answers them with 404. Every request requires an access token. Use MalRequestOptions.fields to select the response shape.

get(params: MalUserGetParams, options?: MalRequestOptions): Promise<MalUser>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const user = await api.user.get(
  { username: "@me" },
  { fields: ["id", "name", "location"] }
);
console.log(user.name);

MyAnimeListUserApi.animeList gets a user's anime list through MalUserOperation.animeList. It is the public facade for GET /users/{user_name}/animelist; username accepts a user name or @me. A public list needs only MalCredentials.clientId (or an access token), since MAL rejects unauthenticated requests. @me and private lists need an access token (a client ID alone cannot resolve @me). The @me check is case-insensitive and ignores surrounding whitespace. Use MalUserAnimeListParams to filter by status, sort, and page with limit/offset.

animeList(params: MalUserAnimeListParams, options?: MalRequestOptions): Promise<MalUserAnimeListResponse>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const list = await api.user.animeList(
  { username: "@me", status: "watching" },
  { fields: ["id", "title", "list_status"] }
);
console.log(list.data[0]?.node.title);

MyAnimeListUserApi.mangaList gets a user's manga list through MalUserOperation.mangaList. It is the public facade for GET /users/{user_name}/mangalist; username accepts a user name or @me. A public list needs only MalCredentials.clientId (or an access token), since MAL rejects unauthenticated requests. @me and private lists need an access token (a client ID alone cannot resolve @me). The @me check is case-insensitive and ignores surrounding whitespace. Use MalUserMangaListParams to filter by status, sort, and page with limit/offset.

mangaList(params: MalUserMangaListParams, options?: MalRequestOptions): Promise<MalUserMangaListResponse>

const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
const list = await api.user.mangaList(
  { username: "@me", status: "reading" },
  { fields: ["id", "title", "list_status"] }
);
console.log(list.data[0]?.node.title);