MyAnimeList

List MyAnimeList user manga list

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

GET/v1/myanimelist/users/{username}/manga-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
54

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

List entry id.

dataentries[]mangaId
integer

Manga id.

dataentries[]title
string

Title.

dataentries[]titleEnglish
stringnullable

English title.

dataentries[]status
integer

List status code.

dataentries[]statusLabel
stringnullable

`Reading`, `Completed`, `On Hold`, `Dropped` or `Plan to Read`.

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[]isRereading
boolean

Rereading flag.

dataentries[]chaptersRead
integer

Chapters read.

dataentries[]volumesRead
integer

Volumes read.

dataentries[]totalChapters
integernullable

Total chapters.

dataentries[]totalVolumes
integernullable

Total volumes.

dataentries[]publishingStatus
integernullable

Publishing status code.

Magazines, when listed.

dataentries[]magazines[]
stringoptional
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.

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

Manga URL.

dataentries[]imageUrl
stringnullable

Cover image.

dataentries[]mediaType
stringnullable

Format.

dataentries[]startDate
stringnullable

List start date.

dataentries[]finishDate
stringnullable

List finish date.

dataentries[]publishedFrom
stringnullable

Publication start date.

dataentries[]publishedTo
stringnullable

Publication end date.

dataentries[]days
numbernullable

Days read.

dataentries[]retail
stringnullable

Retail information.

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/manga-list?status=2" \
  -H "x-api-key: YOUR_API_KEY"

Responses

MyAnimeList user manga list.