MyAnimeList

List MyAnimeList user anime list

List a public MyAnimeList user's anime list with scores, tags and notes.

GET/v1/myanimelist/users/{username}/anime-list
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
usernamestringrequiredpath

Public MyAnimeList member name, e.g. `TheLlama`.

min 2 chars · max 32 chars · pattern: ^[A-Za-z0-9_-]+$

statusintegeroptionalquery

List status filter: 1 watching/reading, 2 completed, 3 on hold, 4 dropped, 6 planned, 7 all. Default: 7.

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 512 chars

Response fields
58

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the entity does not exist (a deleted title, an unknown id or user), not when a list is empty.

one of: found, not_found

datausername
string

Member name.

Entries in this response (up to 300).

dataentries[]id
integer

Anime id.

dataentries[]title
string

Title.

dataentries[]titleEnglish
stringnullable

English title.

dataentries[]status
integer

List status code.

dataentries[]statusLabel
stringnullable

`Watching`, `Completed`, `On Hold`, `Dropped` or `Plan to Watch`.

dataentries[]createdAt
stringnullable

List entry creation time (ISO-8601).

dataentries[]updatedAt
stringnullable

List entry update time (ISO-8601).

dataentries[]score
numbernullable

Score.

dataentries[]tags
stringnullable

Tags.

dataentries[]isRewatching
boolean

Rewatching flag.

dataentries[]watchedEpisodes
integer

Episodes watched.

dataentries[]totalEpisodes
integernullable

Total episodes.

dataentries[]airingStatus
integernullable

Airing status code.

Studios, when listed.

dataentries[]studios[]
stringoptional

Licensors, when listed.

dataentries[]licensors[]
stringoptional
dataentries[]season
stringnullable

Season, when carried.

dataentries[]totalMembers
integernullable

Member count.

dataentries[]totalScores
integernullable

Score count.

dataentries[]scoreValue
numbernullable

Mean score.

dataentries[]scoreDiff
numbernullable

Score difference.

dataentries[]popularity
integernullable

Popularity rank.

dataentries[]hasEpisodeVideo
boolean

Has an episode video.

dataentries[]hasPromotionVideo
boolean

Has a promotion video.

dataentries[]hasVideo
boolean

Has any video.

dataentries[]videoUrl
stringnullable

Video URL.

Genres.

dataentries[]genres[]id
integernullable

MyAnimeList id, when linked.

dataentries[]genres[]name
string

Name.

dataentries[]genres[]url
stringnullable

Entity URL, when linked.

dataentries[]genres[]role
stringnullable

Role, when one is listed (manga authors).

Demographics.

dataentries[]demographics[]id
integernullable

MyAnimeList id, when linked.

dataentries[]demographics[]name
string

Name.

dataentries[]demographics[]url
stringnullable

Entity URL, when linked.

dataentries[]demographics[]role
stringnullable

Role, when one is listed (manga authors).

dataentries[]url
string

Title URL.

dataentries[]imageUrl
stringnullable

Cover image.

dataentries[]mediaType
stringnullable

Format.

dataentries[]rating
stringnullable

Age rating.

dataentries[]startDate
stringnullable

List start date.

dataentries[]finishDate
stringnullable

List finish date.

dataentries[]airedFrom
stringnullable

Airing start date.

dataentries[]airedTo
stringnullable

Airing end date.

dataentries[]days
numbernullable

Days watched.

dataentries[]notes
stringnullable

The member's note on the entry, as plain text.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/myanimelist/users/TheLlama/anime-list?status=2" \
  -H "x-api-key: YOUR_API_KEY"

Responses

MyAnimeList user anime list.