M MyList
Documentation

MyList Public API v1

REST API · JSON · for third parties to build apps and integrations on top of MyList.

Authentication

Generate a token in Settings and send it with every authenticated request:

Authorization: Bearer YOUR_TOKEN_HERE

ID format

Every media item has a source + external_id pair. Supported sources:

  • tmdb_movie — movies (TMDB)
  • tmdb_tv — series, cartoons, some anime (TMDB)
  • mal_anime — anime (MyAnimeList)
  • mal_manga — manga, manhwa, manhua (MyAnimeList)
  • mangadex — manga, manhwa, manhua (MangaDex)

Endpoints

GET/api/v1/search?q=QUERY&scope=all
Aggregated search. scope: all · movie · tv · anime · manga · manhwa · manhua · cartoon · webtoon.
curl "/siteanime/api/v1/search?q=frieren"
GET/api/v1/media/{source}/{external_id}
Full details + aggregated site rating.
curl "/siteanime/api/v1/media/tmdb_movie/550"
GET/api/v1/media/{source}/{external_id}/reviews
Reviews and site rating.
GET/api/v1/users/{username}/list
Public list of a user.
AUTH GET/api/v1/me
Authenticated user info.
AUTH GET/api/v1/me/list?status=watching
My list. Optional status: watching · planned · completed · dropped · paused.
AUTH POST/api/v1/me/list
Add or update a list entry (JSON body).
curl -X POST "/siteanime/api/v1/me/list" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source":"mal_anime","external_id":"20","status":"watching","score":9,"progress_episodes":4}'

Response codes

  • 200 OK
  • 400 invalid parameters
  • 401 invalid or missing token
  • 404 not found

CORS

Enabled for any origin (Access-Control-Allow-Origin: *).