MangaDex

Search MangaDex's manga catalogue and act on your account from a workflow: find manga, chapters, covers, authors, and scanlation groups; read chapter page images; follow and rate manga; keep your library shelves and read markers up to date; and build custom lists and poll their feeds for new releases.

Actions

Action	What it does
Add manga to custom list	Add one manga to one of the account's custom lists.
Check if following	Check whether the connected account follows a particular manga, scanlation group, custom list, or user.
Convert old MangaDex IDs	Translate old numeric MangaDex ids (the ones in pre-2021 links and exports) into the UUIDs the current site uses.
Create custom list	Create a custom list on the connected account, optionally with manga already on it.
Delete custom list	Delete a custom list.
Follow custom list	Follow a custom list so its chapters show up in the account's feeds.
Follow manga	Follow a manga so it shows up in the account's library and its new chapters appear in the followed feed.
Follow scanlation group	Follow a scanlation group with the connected account.
Get a random manga	Pick one manga at random, optionally restricted to (or away from) particular tags.
Get chapter page images	Get the image URL of every page in a chapter, in reading order.
Get chapter statistics	Get the comment counts MangaDex tracks for one or more chapters.
Get cover art	Get one cover by id, including its full-size image URL and which volume it belongs to.
Get custom list	Get one custom list and the ids of the manga on it.
Get custom list feed	Get new chapters across every manga on a custom list, a reading queue you can poll on a schedule.
Get followed manga feed	Get new chapters across every manga the account follows, the MangaDex home feed.
Get manga statistics	Get the follower count and community rating MangaDex tracks for one or more manga.
Get manga volumes and chapters	Summarise a manga's volumes and which chapters are in each, the table of contents behind MangaDex's chapter list.
Get MangaDex author	Get one author or artist by id, with their biography, social links, and the ids of the manga they worked on.
Get MangaDex chapter	Get one chapter by id: its number, volume, language, page count, and the group that released it.
Get MangaDex manga	Get one manga by id: its synopsis, tags, status, authors and artists, and the URL of its current cover.
Get MangaDex user	Get another MangaDex user by id: their username and roles.
Get read chapters	List the chapters of one manga the account has marked as read.
Get read chapters for several manga	List read chapters across several manga in one call, grouped per manga, the batch version of Get read chapters.
Get reading history	List the chapters the account read most recently, newest first, with when each was read.
Get reading status	Get which library shelf one manga is on for the connected account, if any.
Get related manga	List the manga officially related to this one: sequels, prequels, spin-offs, side stories, and adaptations.
Get scanlation group	Get one scanlation group by id: its description, contact links, focus languages, and whether MangaDex considers it active.
Get scanlation group statistics	Get the comment counts MangaDex tracks for one or more scanlation groups.
Get similar manga	Get up to 20 manga MangaDex considers similar to this one, each with a similarity score.
Get your manga ratings	Get the rating the connected account has given one or more manga, and when it was given.
Get your MangaDex account	Get the connected MangaDex account: its username, id, and roles.
List another user's custom lists	List the public custom lists belonging to another user.
List cover art	List cover art (usually every volume cover of one manga) with a full-size image URL and a thumbnail for each.
List followed custom lists	List the custom lists the connected account follows.
List followed manga	List the manga the connected account follows, with covers and tags, the account's library.
List followed scanlation groups	List the scanlation groups the connected account follows.
List followed users	List the MangaDex users the connected account follows.
List library shelves	List every manga in the account's library with the shelf it is on, optionally just one shelf.
List manga chapters	List a manga's chapters, newest first by default, with their numbers, languages, scanlation groups, and publish dates.
List MangaDex tags	List every genre, theme, format, and content tag a manga can carry, with the ids the search filters take.
List report reasons	List the reasons MangaDex accepts for reporting a manga, chapter, group, user, or author, and whether each one needs written details.
List your custom lists	List the connected account's own custom lists, public and private alike.
List your reports	List the reports the connected account has filed and how MangaDex resolved each one.
Mark chapters read or unread	Mark chapters of one manga as read, as unread, or both at once.
Rate a manga	Give a manga a rating out of 10 from the connected account, replacing any rating already on it.
Remove a manga rating	Remove the connected account's rating from a manga.
Remove manga from custom list	Take one manga off one of the account's custom lists.
Search MangaDex	Search MangaDex's catalogue by title, tag, status, demographic, release year, or translation language, and get back each match's synopsis, tags, authors, and cover image.
Search MangaDex authors	Search the authors and artists MangaDex credits, and get back each one's biography, links, and the manga they worked on.
Search MangaDex chapters	Search chapters across the whole site: by title, by manga, by scanlation group, or by chapter and volume number.
Search scanlation groups	Search the scanlation groups that translate and upload chapters, and see which languages each one works in.
Set reading status	Put a manga on one of the account's library shelves: reading, plan to read, completed, on hold, dropped, or re-reading.
Unfollow custom list	Stop following a custom list.
Unfollow manga	Stop following a manga.
Unfollow scanlation group	Stop following a scanlation group.
Update custom list	Rename a custom list, change who can see it, or replace the manga on it.

Add manga to custom list

Add one manga to one of the account's custom lists.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.
Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

list_idtext
manga_idtext
on_listtrue/false

Example output

{
  "list_id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
  "on_list": true
}

Check if following

Check whether the connected account follows a particular manga, scanlation group, custom list, or user. Use it to branch a workflow on something already being followed.

Inputs

What to checktargettextRequired: Which kind of thing the id below refers to.One of: manga, group (Scanlation group), list (Custom list), user.
IDtarget_idtextRequired: The id of the manga, group, list, or user.

Outputs

followingtrue/false: Whether the account follows it.
targettext: manga, group, list, or user.
target_idtext

Example output

{
  "following": true,
  "target": "manga",
  "target_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
}

Convert old MangaDex IDs

Translate old numeric MangaDex ids (the ones in pre-2021 links and exports) into the UUIDs the current site uses.

Inputs

ID typeid_typetextRequired: What the old ids refer to.One of: manga, chapter, group (Scanlation group), tag.
Old IDslegacy_idslistRequired: The old numeric ids to convert, e.g. 1 or 47.

Outputs

countnumber
mappingslist

Example output

{
  "count": 1,
  "mappings": [
    {
      "legacy_id": 1,
      "new_id": "c0ee660b-f9f2-45c3-8068-5123ff53f84a",
      "type": "manga"
    }
  ]
}

Create custom list

Create a custom list on the connected account, optionally with manga already on it. Lists are private unless made public.

Inputs

List namenametextRequired: What to call the list.
Visibilityvisibilitytext: Who can see the list. Defaults to private.One of: private (Private: only you can see it), public (Public: anyone with the link can see it).
Manga IDsmanga_idslist: Manga to put on the list straight away.

Outputs

listobject

Example output

{
  "list": {
    "id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
    "manga_count": 1,
    "manga_ids": [
      "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
    ],
    "name": "Weekend reading",
    "owner_id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
    "url": "https://mangadex.org/list/1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
    "version": 1,
    "visibility": "private"
  }
}

Delete custom list

Delete a custom list. This cannot be undone.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.

Outputs

deletedtrue/false
list_idtext

Example output

{
  "deleted": true,
  "list_id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d"
}

Follow custom list

Follow a custom list so its chapters show up in the account's feeds.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.

Outputs

followingtrue/false
list_idtext

Example output

{
  "following": true,
  "list_id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d"
}

Follow manga

Follow a manga so it shows up in the account's library and its new chapters appear in the followed feed.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

followingtrue/false
manga_idtext

Example output

{
  "following": true,
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
}

Follow scanlation group

Follow a scanlation group with the connected account.

Inputs

Scanlation group IDgroup_idtextRequired: The group's id, from a Search MangaDex scanlation groups step.

Outputs

followingtrue/false
group_idtext

Example output

{
  "following": true,
  "group_id": "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
}

Get a random manga

Pick one manga at random, optionally restricted to (or away from) particular tags. Good for a daily recommendation.

Inputs

Include tagsincluded_tagslist: Only return manga carrying these tags.
Exclude tagsexcluded_tagslist: Leave out manga carrying these tags.
Content ratingscontent_ratingtext: Which content ratings to include. Defaults to everything except pornographic, the same as MangaDex's own default.One or more of: safe, suggestive, erotica, pornographic.

Outputs

mangaobject

Example output

{
  "manga": {
    "artists": [
      "Fujimoto Tatsuki"
    ],
    "authors": [
      "Fujimoto Tatsuki"
    ],
    "available_translated_languages": [
      "en",
      "es-la",
      "pt-br"
    ],
    "content_rating": "suggestive",
    "cover_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
    "created_at": "2019-09-10T13:07:45+00:00",
    "demographic": "shounen",
    "description": "Broke young man + chainsaw dog demon = Chainsaw Man!",
    "id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
    "last_chapter": "232",
    "last_volume": "",
    "original_language": "ja",
    "status": "completed",
    "tags": [
      "Action",
      "Comedy",
      "Supernatural"
    ],
    "title": "Chainsaw Man",
    "updated_at": "2026-03-24T15:18:24+00:00",
    "url": "https://mangadex.org/title/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
    "year": 2018
  }
}

Get chapter page images

Get the image URL of every page in a chapter, in reading order. The URLs are issued per request and are short-lived, so use them in the same run rather than storing them.

Inputs

Chapter IDchapter_idtextRequired: The chapter's id. Take it from a chapter-listing step, or copy it out of a mangadex.org/chapter/... link.
Use compressed imagesdata_savertrue/false: Return the smaller, more compressed copies instead of the originals.

Outputs

data_savertrue/false: Whether the compressed copies were used.
page_countnumber
page_urlslist: One image URL per page, in reading order.

Example output

{
  "data_saver": false,
  "page_count": 1,
  "page_urls": [
    "https://cmdxd98sb0x3yprd.mangadex.network/data/9aab5b090256c87568c308531a28441d/1-02bb3ed8e3a7.png"
  ]
}

Get chapter statistics

Get the comment counts MangaDex tracks for one or more chapters.

Inputs

Chapter IDschapter_idslistRequired: One or more chapter ids to look up.

Outputs

countnumber
statisticslist

Example output

{
  "count": 1,
  "statistics": [
    {
      "average_rating": null,
      "bayesian_rating": null,
      "chapter_id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "comment_count": 67,
      "comment_thread_id": 803670,
      "follows": null
    }
  ]
}

Get cover art

Get one cover by id, including its full-size image URL and which volume it belongs to.

Inputs

Cover IDcover_idtextRequired: The cover's id, from a List cover art step.

Outputs

coverobject

Example output

{
  "cover": {
    "created_at": "2021-03-19T11:30:19+00:00",
    "description": null,
    "file_name": "6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
    "id": "6e518bd1-5f60-446b-8832-bfe6bf74834b",
    "image_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
    "locale": "ja",
    "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
    "thumbnail_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg.256.jpg",
    "updated_at": "2021-03-19T11:30:19+00:00",
    "volume": "1"
  }
}

Get custom list

Get one custom list and the ids of the manga on it.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.

Outputs

listobject

Example output

{
  "list": {
    "id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
    "manga_count": 1,
    "manga_ids": [
      "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
    ],
    "name": "Weekend reading",
    "owner_id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
    "url": "https://mangadex.org/list/1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
    "version": 1,
    "visibility": "private"
  }
}

Get custom list feed

Get new chapters across every manga on a custom list, a reading queue you can poll on a schedule.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.
Chapter languagetranslated_languagetext: Only include chapters translated into this language.
Content ratingscontent_ratingtext: Which content ratings to include. Defaults to everything except pornographic, the same as MangaDex's own default.One or more of: safe, suggestive, erotica, pornographic.
Only chapters readable on MangaDexexclude_external_chapterstrue/false: Leave out chapters that are only readable on another site, such as an official publisher's reader. Those have no page images here, so turn this on when the workflow goes on to fetch pages.
Sort bysorttext: What order to return the chapters in.One of: readableAt:desc (Recently readable), publishAt:desc (Newest first), publishAt:asc (Oldest first), chapter:asc (Chapter number, low to high), chapter:desc (Chapter number, high to low), volume:asc (Volume, low to high), createdAt:desc (Recently uploaded), updatedAt:desc (Recently edited).
Maximum chapterslimitnumber: How many chapters to return, 1 to 500. Defaults to 100.From 1 to 500.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

chapterslist: Chapters from the manga on the list.
countnumber: How many items this step returned.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "chapters": [
    {
      "chapter": "1",
      "created_at": "2019-12-03T18:04:04+00:00",
      "external_url": null,
      "group_ids": [
        "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
      ],
      "groups": [
        "Ruri Scans"
      ],
      "id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "language": "en",
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "manga_title": "Chainsaw Man",
      "pages": 53,
      "published_at": "2019-12-03T18:04:04+00:00",
      "readable_at": "2019-12-03T18:04:04+00:00",
      "title": "Chainsaw Man",
      "updated_at": "2021-05-04T10:12:31+00:00",
      "url": "https://mangadex.org/chapter/19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "volume": "1"
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0,
  "total": 1
}

Get followed manga feed

Get new chapters across every manga the account follows, the MangaDex home feed. Pair it with a schedule to be told about new releases.

Inputs

Chapter languagetranslated_languagetext: Only include chapters translated into this language.
Content ratingscontent_ratingtext: Which content ratings to include. Defaults to everything except pornographic, the same as MangaDex's own default.One or more of: safe, suggestive, erotica, pornographic.
Only chapters readable on MangaDexexclude_external_chapterstrue/false: Leave out chapters that are only readable on another site, such as an official publisher's reader. Those have no page images here, so turn this on when the workflow goes on to fetch pages.
Sort bysorttext: What order to return the chapters in.One of: readableAt:desc (Recently readable), publishAt:desc (Newest first), publishAt:asc (Oldest first), chapter:asc (Chapter number, low to high), chapter:desc (Chapter number, high to low), volume:asc (Volume, low to high), createdAt:desc (Recently uploaded), updatedAt:desc (Recently edited).
Maximum chapterslimitnumber: How many chapters to return, 1 to 500. Defaults to 100.From 1 to 500.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

chapterslist: Chapters from followed manga.
countnumber: How many items this step returned.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "chapters": [
    {
      "chapter": "1",
      "created_at": "2019-12-03T18:04:04+00:00",
      "external_url": null,
      "group_ids": [
        "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
      ],
      "groups": [
        "Ruri Scans"
      ],
      "id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "language": "en",
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "manga_title": "Chainsaw Man",
      "pages": 53,
      "published_at": "2019-12-03T18:04:04+00:00",
      "readable_at": "2019-12-03T18:04:04+00:00",
      "title": "Chainsaw Man",
      "updated_at": "2021-05-04T10:12:31+00:00",
      "url": "https://mangadex.org/chapter/19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "volume": "1"
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0,
  "total": 1
}

Get manga statistics

Get the follower count and community rating MangaDex tracks for one or more manga.

Inputs

Manga IDsmanga_idslistRequired: One or more manga ids to look up.

Outputs

countnumber
statisticslist

Example output

{
  "count": 1,
  "statistics": [
    {
      "average_rating": 9.23,
      "bayesian_rating": 9.22,
      "comment_count": 788,
      "comment_thread_id": 76734,
      "follows": 201492,
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
    }
  ]
}

Get manga volumes and chapters

Summarise a manga's volumes and which chapters are in each, the table of contents behind MangaDex's chapter list.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.
Chapter languagetranslated_languagetext: Only include chapters translated into this language.

Outputs

chapter_countnumber
volume_countnumber
volumeslist: One entry per volume, newest first.

Example output

{
  "chapter_count": 1,
  "volume_count": 1,
  "volumes": [
    {
      "chapter_count": 1,
      "chapters": [
        {
          "chapter": "1",
          "count": 1,
          "id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713"
        }
      ],
      "volume": "1"
    }
  ]
}

Get MangaDex author

Get one author or artist by id, with their biography, social links, and the ids of the manga they worked on.

Inputs

Author IDauthor_idtextRequired: The author's id, from a Search MangaDex authors step.

Outputs

authorobject

Example output

{
  "author": {
    "biography": "Japanese manga artist.",
    "created_at": "2021-04-19T21:59:45+00:00",
    "id": "0c85bd60-a1f8-4bcd-b0f7-4b41b57f2ffa",
    "image_url": null,
    "manga_ids": [
      "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
    ],
    "name": "Fujimoto Tatsuki",
    "pixiv": null,
    "twitter": "https://twitter.com/nagayama_koharu",
    "updated_at": "2023-01-11T09:12:03+00:00",
    "website": null
  }
}

Get MangaDex chapter

Get one chapter by id: its number, volume, language, page count, and the group that released it.

Inputs

Chapter IDchapter_idtextRequired: The chapter's id. Take it from a chapter-listing step, or copy it out of a mangadex.org/chapter/... link.

Outputs

chapterobject

Example output

{
  "chapter": {
    "chapter": "1",
    "created_at": "2019-12-03T18:04:04+00:00",
    "external_url": null,
    "group_ids": [
      "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
    ],
    "groups": [
      "Ruri Scans"
    ],
    "id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
    "language": "en",
    "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
    "manga_title": "Chainsaw Man",
    "pages": 53,
    "published_at": "2019-12-03T18:04:04+00:00",
    "readable_at": "2019-12-03T18:04:04+00:00",
    "title": "Chainsaw Man",
    "updated_at": "2021-05-04T10:12:31+00:00",
    "url": "https://mangadex.org/chapter/19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
    "volume": "1"
  }
}

Get MangaDex manga

Get one manga by id: its synopsis, tags, status, authors and artists, and the URL of its current cover.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

mangaobject

Example output

{
  "manga": {
    "artists": [
      "Fujimoto Tatsuki"
    ],
    "authors": [
      "Fujimoto Tatsuki"
    ],
    "available_translated_languages": [
      "en",
      "es-la",
      "pt-br"
    ],
    "content_rating": "suggestive",
    "cover_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
    "created_at": "2019-09-10T13:07:45+00:00",
    "demographic": "shounen",
    "description": "Broke young man + chainsaw dog demon = Chainsaw Man!",
    "id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
    "last_chapter": "232",
    "last_volume": "",
    "original_language": "ja",
    "status": "completed",
    "tags": [
      "Action",
      "Comedy",
      "Supernatural"
    ],
    "title": "Chainsaw Man",
    "updated_at": "2026-03-24T15:18:24+00:00",
    "url": "https://mangadex.org/title/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
    "year": 2018
  }
}

Get MangaDex user

Get another MangaDex user by id: their username and roles.

Inputs

User IDuser_idtextRequired: The user's id, from a mangadex.org/user/... link or an earlier step.

Outputs

userobject

Example output

{
  "user": {
    "group_ids": [],
    "id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
    "roles": [
      "ROLE_USER"
    ],
    "url": "https://mangadex.org/user/cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
    "username": "reader"
  }
}

Get read chapters

List the chapters of one manga the account has marked as read.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

chapter_idslist: Ids of the chapters marked as read.
countnumber
manga_idtext

Example output

{
  "chapter_ids": [
    "19086fe2-d9c2-47ea-b8e6-f62f0d60a713"
  ],
  "count": 1,
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
}

Get read chapters for several manga

List read chapters across several manga in one call, grouped per manga, the batch version of Get read chapters.

Inputs

Manga IDsmanga_idslistRequired: The manga to look up read chapters for.

Outputs

chapter_countnumber: Total read chapters across them.
countnumber: How many manga came back with read chapters.
mangalist

Example output

{
  "chapter_count": 1,
  "count": 1,
  "manga": [
    {
      "chapter_ids": [
        "19086fe2-d9c2-47ea-b8e6-f62f0d60a713"
      ],
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
    }
  ]
}

Get reading history

List the chapters the account read most recently, newest first, with when each was read.

Inputs

None.

Outputs

countnumber
historylist

Example output

{
  "count": 1,
  "history": [
    {
      "chapter_id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "read_at": "2026-08-01T09:15:00+00:00"
    }
  ]
}

Get reading status

Get which library shelf one manga is on for the connected account, if any.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

manga_idtext
statustext: reading, plan_to_read, completed, on_hold, dropped, re_reading, or null when it isn't in the library.

Example output

{
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
  "status": "reading"
}

List the manga officially related to this one: sequels, prequels, spin-offs, side stories, and adaptations.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

countnumber
relationslist

Example output

{
  "count": 1,
  "relations": [
    {
      "manga_id": "192b2c21-e762-4927-8261-dc96adf11b0c",
      "relation": "side_story",
      "url": "https://mangadex.org/title/192b2c21-e762-4927-8261-dc96adf11b0c"
    }
  ]
}

Get scanlation group

Get one scanlation group by id: its description, contact links, focus languages, and whether MangaDex considers it active.

Inputs

Scanlation group IDgroup_idtextRequired: The group's id, from a Search MangaDex scanlation groups step.

Outputs

groupobject

Example output

{
  "group": {
    "contact_email": null,
    "created_at": "2020-01-05T12:00:00+00:00",
    "description": "Weekly releases.",
    "discord": null,
    "focused_languages": [
      "en"
    ],
    "id": "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a",
    "inactive": false,
    "name": "Ruri Scans",
    "official": false,
    "twitter": null,
    "updated_at": "2025-11-02T08:30:00+00:00",
    "verified": false,
    "website": "https://example.org"
  }
}

Get scanlation group statistics

Get the comment counts MangaDex tracks for one or more scanlation groups.

Inputs

Scanlation group IDsgroup_idslistRequired: One or more group ids to look up.

Outputs

countnumber
statisticslist

Example output

{
  "count": 1,
  "statistics": [
    {
      "average_rating": null,
      "bayesian_rating": null,
      "comment_count": 12,
      "comment_thread_id": 55123,
      "follows": null,
      "group_id": "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
    }
  ]
}

Get similar manga

Get up to 20 manga MangaDex considers similar to this one, each with a similarity score.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.
Content ratingscontent_ratingtext: Which content ratings to include. Defaults to everything except pornographic, the same as MangaDex's own default.One or more of: safe, suggestive, erotica, pornographic.
Sort bysorttext: Whether the closest matches come first.One of: score:desc (Most similar first), score:asc (Least similar first).

Outputs

countnumber
recommendationslist

Example output

{
  "count": 1,
  "recommendations": [
    {
      "manga_id": "106caf05-81c1-47bc-9fc2-57d8c6d7a106",
      "score": 0.7,
      "title": "Fire Punch",
      "url": "https://mangadex.org/title/106caf05-81c1-47bc-9fc2-57d8c6d7a106"
    }
  ]
}

Get your manga ratings

Get the rating the connected account has given one or more manga, and when it was given.

Inputs

Manga IDsmanga_idslistRequired: The manga to read your own ratings for.

Outputs

countnumber
ratingslist

Example output

{
  "count": 1,
  "ratings": [
    {
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "rated_at": "2026-01-04T08:47:37+00:00",
      "rating": 9
    }
  ]
}

Get your MangaDex account

Get the connected MangaDex account: its username, id, and roles. Useful for confirming which account a workflow acts as.

Inputs

None.

Outputs

userobject

Example output

{
  "user": {
    "group_ids": [],
    "id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
    "roles": [
      "ROLE_USER"
    ],
    "url": "https://mangadex.org/user/cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
    "username": "reader"
  }
}

List another user's custom lists

List the public custom lists belonging to another user.

Inputs

User IDuser_idtextRequired: The user's id. Take it from a Get MangaDex account step or a mangadex.org/user/... link.
Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
limitnumber: The page size that was used.
listslist: That user's public lists.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "limit": 10,
  "lists": [
    {
      "id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
      "manga_count": 1,
      "manga_ids": [
        "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
      ],
      "name": "Weekend reading",
      "owner_id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
      "url": "https://mangadex.org/list/1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
      "version": 1,
      "visibility": "private"
    }
  ],
  "offset": 0,
  "total": 1
}

List cover art

List cover art (usually every volume cover of one manga) with a full-size image URL and a thumbnail for each.

Inputs

Manga IDsmanga_idslist: Only return covers belonging to these manga.
Edition languageslocaleslist: Only return covers of these editions: ja for the Japanese release, en for the English one.
Sort bysorttext: What order to return the covers in.One of: volume:asc (Volume, low to high), volume:desc (Volume, high to low), createdAt:desc (Recently added), updatedAt:desc (Recently edited).
Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
coverslist: The matching covers.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "covers": [
    {
      "created_at": "2021-03-19T11:30:19+00:00",
      "description": null,
      "file_name": "6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
      "id": "6e518bd1-5f60-446b-8832-bfe6bf74834b",
      "image_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
      "locale": "ja",
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "thumbnail_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg.256.jpg",
      "updated_at": "2021-03-19T11:30:19+00:00",
      "volume": "1"
    }
  ],
  "limit": 10,
  "offset": 0,
  "total": 1
}

List followed custom lists

List the custom lists the connected account follows.

Inputs

Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
limitnumber: The page size that was used.
listslist: The followed custom lists.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "limit": 10,
  "lists": [
    {
      "id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
      "manga_count": 1,
      "manga_ids": [
        "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
      ],
      "name": "Weekend reading",
      "owner_id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
      "url": "https://mangadex.org/list/1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
      "version": 1,
      "visibility": "private"
    }
  ],
  "offset": 0,
  "total": 1
}

List followed manga

List the manga the connected account follows, with covers and tags, the account's library.

Inputs

Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
limitnumber: The page size that was used.
mangalist: The followed manga.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "limit": 10,
  "manga": [
    {
      "artists": [
        "Fujimoto Tatsuki"
      ],
      "authors": [
        "Fujimoto Tatsuki"
      ],
      "available_translated_languages": [
        "en",
        "es-la",
        "pt-br"
      ],
      "content_rating": "suggestive",
      "cover_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
      "created_at": "2019-09-10T13:07:45+00:00",
      "demographic": "shounen",
      "description": "Broke young man + chainsaw dog demon = Chainsaw Man!",
      "id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "last_chapter": "232",
      "last_volume": "",
      "original_language": "ja",
      "status": "completed",
      "tags": [
        "Action",
        "Comedy",
        "Supernatural"
      ],
      "title": "Chainsaw Man",
      "updated_at": "2026-03-24T15:18:24+00:00",
      "url": "https://mangadex.org/title/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "year": 2018
    }
  ],
  "offset": 0,
  "total": 1
}

List followed scanlation groups

List the scanlation groups the connected account follows.

Inputs

Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
groupslist: The followed groups.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "groups": [
    {
      "contact_email": null,
      "created_at": "2020-01-05T12:00:00+00:00",
      "description": "Weekly releases.",
      "discord": null,
      "focused_languages": [
        "en"
      ],
      "id": "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a",
      "inactive": false,
      "name": "Ruri Scans",
      "official": false,
      "twitter": null,
      "updated_at": "2025-11-02T08:30:00+00:00",
      "verified": false,
      "website": "https://example.org"
    }
  ],
  "limit": 10,
  "offset": 0,
  "total": 1
}

List followed users

List the MangaDex users the connected account follows.

Inputs

Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.
userslist: The followed users.

Example output

{
  "count": 1,
  "limit": 10,
  "offset": 0,
  "total": 1,
  "users": [
    {
      "group_ids": [],
      "id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
      "roles": [
        "ROLE_USER"
      ],
      "url": "https://mangadex.org/user/cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
      "username": "reader"
    }
  ]
}

List library shelves

List every manga in the account's library with the shelf it is on, optionally just one shelf.

Inputs

Shelfstatustext: Only return manga on this shelf.One of: reading, plan_to_read (Plan to read), completed, on_hold (On hold), dropped, re_reading (Re-reading).

Outputs

countnumber
statuseslist

Example output

{
  "count": 1,
  "statuses": [
    {
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "status": "reading"
    }
  ]
}

List manga chapters

List a manga's chapters, newest first by default, with their numbers, languages, scanlation groups, and publish dates.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.
Chapter languagetranslated_languagetext: Only include chapters translated into this language.
Content ratingscontent_ratingtext: Which content ratings to include. Defaults to everything except pornographic, the same as MangaDex's own default.One or more of: safe, suggestive, erotica, pornographic.
Published sincepublished_sincedate and time: Only include chapters published at or after this moment. Handy for a scheduled workflow that should only see what is new.
Only chapters readable on MangaDexexclude_external_chapterstrue/false: Leave out chapters that are only readable on another site, such as an official publisher's reader. Those have no page images here, so turn this on when the workflow goes on to fetch pages.
Sort bysorttext: What order to return the chapters in.One of: readableAt:desc (Recently readable), publishAt:desc (Newest first), publishAt:asc (Oldest first), chapter:asc (Chapter number, low to high), chapter:desc (Chapter number, high to low), volume:asc (Volume, low to high), createdAt:desc (Recently uploaded), updatedAt:desc (Recently edited).
Maximum chapterslimitnumber: How many chapters to return, 1 to 500. Defaults to 100.From 1 to 500.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

chapterslist: The manga's chapters.
countnumber: How many items this step returned.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "chapters": [
    {
      "chapter": "1",
      "created_at": "2019-12-03T18:04:04+00:00",
      "external_url": null,
      "group_ids": [
        "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
      ],
      "groups": [
        "Ruri Scans"
      ],
      "id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "language": "en",
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "manga_title": "Chainsaw Man",
      "pages": 53,
      "published_at": "2019-12-03T18:04:04+00:00",
      "readable_at": "2019-12-03T18:04:04+00:00",
      "title": "Chainsaw Man",
      "updated_at": "2021-05-04T10:12:31+00:00",
      "url": "https://mangadex.org/chapter/19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "volume": "1"
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0,
  "total": 1
}

List MangaDex tags

List every genre, theme, format, and content tag a manga can carry, with the ids the search filters take.

Inputs

None.

Outputs

countnumber: How many tags there are.
tagslist: Every tag MangaDex defines.

Example output

{
  "count": 1,
  "tags": [
    {
      "description": null,
      "group": "genre",
      "id": "391b0423-d847-456f-aff0-8b0cfc03066b",
      "name": "Action"
    }
  ]
}

List report reasons

List the reasons MangaDex accepts for reporting a manga, chapter, group, user, or author, and whether each one needs written details.

Inputs

Report aboutcategorytextRequired: Which kind of thing the reasons are for.One of: manga, chapter, scanlation_group (Scanlation group), user, author.

Outputs

countnumber
reasonslist

Example output

{
  "count": 1,
  "reasons": [
    {
      "category": "manga",
      "details_required": true,
      "id": "1a0b6e60-cacd-453f-ba16-b0aafee3ddad",
      "reason": "Incorrect or missing volume numbers"
    }
  ]
}

List your custom lists

List the connected account's own custom lists, public and private alike.

Inputs

Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
limitnumber: The page size that was used.
listslist: Your custom lists.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "limit": 10,
  "lists": [
    {
      "id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
      "manga_count": 1,
      "manga_ids": [
        "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
      ],
      "name": "Weekend reading",
      "owner_id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
      "url": "https://mangadex.org/list/1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
      "version": 1,
      "visibility": "private"
    }
  ],
  "offset": 0,
  "total": 1
}

List your reports

List the reports the connected account has filed and how MangaDex resolved each one.

Inputs

Report aboutcategorytext: Only return reports about this kind of thing.One of: manga, chapter, scanlation_group (Scanlation group), user, author.
Outcomestatustext: Only return reports in this state.One of: waiting, accepted, refused, autoresolved (Auto-resolved).
Sort bysorttext: What order to return the reports in.One of: createdAt:desc (Newest first), createdAt:asc (Oldest first).
Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
reportslist
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "limit": 10,
  "offset": 0,
  "reports": [
    {
      "created_at": "2026-07-14T10:00:00+00:00",
      "details": "Chapter is a duplicate.",
      "id": "b8f3a5c1-6d2e-4f7a-9b0c-1d2e3f4a5b6c",
      "object_id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "reason_id": "1a0b6e60-cacd-453f-ba16-b0aafee3ddad",
      "status": "waiting"
    }
  ],
  "total": 1
}

Mark chapters read or unread

Mark chapters of one manga as read, as unread, or both at once. Give at least one chapter id.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.
Mark as readread_chapter_idslist: Ids of the chapters to mark as read.
Mark as unreadunread_chapter_idslist: Ids of the chapters to mark as unread.
Add to reading historyupdate_historytrue/false: Also record these chapters in the account's reading history, as opening them in the reader would.

Outputs

manga_idtext
marked_readlist
marked_unreadlist

Example output

{
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
  "marked_read": [
    "19086fe2-d9c2-47ea-b8e6-f62f0d60a713"
  ],
  "marked_unread": []
}

Rate a manga

Give a manga a rating out of 10 from the connected account, replacing any rating already on it.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.
RatingratingnumberRequired: A whole number from 1 to 10.From 1 to 10.

Outputs

manga_idtext
ratingnumber: The rating that was set.

Example output

{
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
  "rating": 9
}

Remove a manga rating

Remove the connected account's rating from a manga.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

manga_idtext
ratingnumber: Null, since the rating was removed.

Example output

{
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
  "rating": null
}

Remove manga from custom list

Take one manga off one of the account's custom lists.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.
Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

list_idtext
manga_idtext
on_listtrue/false

Example output

{
  "list_id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
  "on_list": false
}

Search MangaDex

Search MangaDex's catalogue by title, tag, status, demographic, release year, or translation language, and get back each match's synopsis, tags, authors, and cover image.

Inputs

Title containstitletext: Words from the title to search for.
Include tagsincluded_tagslist: Only return manga carrying these tags.
Included tags mustincluded_tags_modetext: Whether a manga has to carry every included tag or just one of them. Defaults to all of them.One of: AND (Match all of them), OR (Match any of them).
Exclude tagsexcluded_tagslist: Leave out manga carrying these tags.
Excluded tags mustexcluded_tags_modetext: Whether a manga is left out for carrying every excluded tag or any one of them. Defaults to any of them.One of: AND (Match all of them), OR (Match any of them).
Publication statusstatustext: Only return manga in these states.One or more of: ongoing, completed, hiatus (On hiatus), cancelled.
Demographicdemographictext: Only return manga aimed at these readerships.One or more of: shounen, shoujo, seinen, josei, none (None given).
Content ratingscontent_ratingtext: Which content ratings to include. Defaults to everything except pornographic, the same as MangaDex's own default.One or more of: safe, suggestive, erotica, pornographic.
Originally written inoriginal_languagetext: Only return manga first published in this language: Japanese for manga, Korean for manhwa, Chinese for manhua.
Has chapters inavailable_translated_languagetext: Only return manga with chapters in this language.
Release yearyearnumber: Only return manga first released in this year.From 1900 to 2100.
Author or artist IDauthor_or_artisttext: Only return manga this person wrote or drew. Use a Search MangaDex authors step to get the id.
Only manga with chaptershas_available_chapterstrue/false: Leave out entries that have no readable chapters yet.
Updated sinceupdated_sincedate and time: Only return manga edited at or after this moment.
Sort bysorttext: What order to return results in. Defaults to recently updated.One of: relevance:desc (Best match), followedCount:desc (Most followed), rating:desc (Highest rated), latestUploadedChapter:desc (Recently updated), createdAt:desc (Newest on MangaDex), updatedAt:desc (Recently edited), year:desc (Newest by release year), title:asc (Title A–Z).
Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
limitnumber: The page size that was used.
mangalist: The matching manga.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "limit": 10,
  "manga": [
    {
      "artists": [
        "Fujimoto Tatsuki"
      ],
      "authors": [
        "Fujimoto Tatsuki"
      ],
      "available_translated_languages": [
        "en",
        "es-la",
        "pt-br"
      ],
      "content_rating": "suggestive",
      "cover_url": "https://uploads.mangadex.org/covers/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b/6e518bd1-5f60-446b-8832-bfe6bf74834b.jpg",
      "created_at": "2019-09-10T13:07:45+00:00",
      "demographic": "shounen",
      "description": "Broke young man + chainsaw dog demon = Chainsaw Man!",
      "id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "last_chapter": "232",
      "last_volume": "",
      "original_language": "ja",
      "status": "completed",
      "tags": [
        "Action",
        "Comedy",
        "Supernatural"
      ],
      "title": "Chainsaw Man",
      "updated_at": "2026-03-24T15:18:24+00:00",
      "url": "https://mangadex.org/title/a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "year": 2018
    }
  ],
  "offset": 0,
  "total": 1
}

Search MangaDex authors

Search the authors and artists MangaDex credits, and get back each one's biography, links, and the manga they worked on.

Inputs

Name containsnametext: Part of the author's or artist's name.
Sort bysorttext: What order to return the results in.One of: name:asc (Name A–Z), name:desc (Name Z–A).
Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

authorslist: The matching authors and artists.
countnumber: How many items this step returned.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "authors": [
    {
      "biography": "Japanese manga artist.",
      "created_at": "2021-04-19T21:59:45+00:00",
      "id": "0c85bd60-a1f8-4bcd-b0f7-4b41b57f2ffa",
      "image_url": null,
      "manga_ids": [
        "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
      ],
      "name": "Fujimoto Tatsuki",
      "pixiv": null,
      "twitter": "https://twitter.com/nagayama_koharu",
      "updated_at": "2023-01-11T09:12:03+00:00",
      "website": null
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0,
  "total": 1
}

Search MangaDex chapters

Search chapters across the whole site: by title, by manga, by scanlation group, or by chapter and volume number.

Inputs

Chapter title containstitletext: Words from the chapter's own title.
Manga IDmanga_idtext: Only return chapters of this manga.
Scanlation group IDsgroup_idslist: Only return chapters released by these groups.
Chapter numberchaptertext: Only return this chapter number, e.g. 12.
Volume numbervolumetext: Only return chapters from this volume.
Chapter languagetranslated_languagetext: Only include chapters translated into this language.
Content ratingscontent_ratingtext: Which content ratings to include. Defaults to everything except pornographic, the same as MangaDex's own default.One or more of: safe, suggestive, erotica, pornographic.
Published sincepublished_sincedate and time: Only include chapters published at or after this moment. Handy for a scheduled workflow that should only see what is new.
Only chapters readable on MangaDexexclude_external_chapterstrue/false: Leave out chapters that are only readable on another site, such as an official publisher's reader. Those have no page images here, so turn this on when the workflow goes on to fetch pages.
Sort bysorttext: What order to return the chapters in.One of: readableAt:desc (Recently readable), publishAt:desc (Newest first), publishAt:asc (Oldest first), chapter:asc (Chapter number, low to high), chapter:desc (Chapter number, high to low), volume:asc (Volume, low to high), createdAt:desc (Recently uploaded), updatedAt:desc (Recently edited).
Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

chapterslist: The matching chapters.
countnumber: How many items this step returned.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "chapters": [
    {
      "chapter": "1",
      "created_at": "2019-12-03T18:04:04+00:00",
      "external_url": null,
      "group_ids": [
        "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
      ],
      "groups": [
        "Ruri Scans"
      ],
      "id": "19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "language": "en",
      "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
      "manga_title": "Chainsaw Man",
      "pages": 53,
      "published_at": "2019-12-03T18:04:04+00:00",
      "readable_at": "2019-12-03T18:04:04+00:00",
      "title": "Chainsaw Man",
      "updated_at": "2021-05-04T10:12:31+00:00",
      "url": "https://mangadex.org/chapter/19086fe2-d9c2-47ea-b8e6-f62f0d60a713",
      "volume": "1"
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0,
  "total": 1
}

Search scanlation groups

Search the scanlation groups that translate and upload chapters, and see which languages each one works in.

Inputs

Name containsnametext: Part of the group's name.
Translates intofocused_languagetext: Only return groups that focus on this language.
Sort bysorttext: What order to return the groups in.One of: relevance:desc (Best match), latestUploadedChapter:desc (Recently active), followedCount:desc (Most followed), name:asc (Name A–Z), createdAt:desc (Newest group).
Maximum resultslimitnumber: How many results to return, 1 to 100. Defaults to 10.From 1 to 100.
Skipoffsetnumber: How many results to skip, for paging past the first batch.At least 0.

Outputs

countnumber: How many items this step returned.
groupslist: The matching scanlation groups.
limitnumber: The page size that was used.
offsetnumber: How many items were skipped.
totalnumber: How many items match in total, across all pages.

Example output

{
  "count": 1,
  "groups": [
    {
      "contact_email": null,
      "created_at": "2020-01-05T12:00:00+00:00",
      "description": "Weekly releases.",
      "discord": null,
      "focused_languages": [
        "en"
      ],
      "id": "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a",
      "inactive": false,
      "name": "Ruri Scans",
      "official": false,
      "twitter": null,
      "updated_at": "2025-11-02T08:30:00+00:00",
      "verified": false,
      "website": "https://example.org"
    }
  ],
  "limit": 10,
  "offset": 0,
  "total": 1
}

Set reading status

Put a manga on one of the account's library shelves: reading, plan to read, completed, on hold, dropped, or re-reading. Leave the status blank to take it off the shelves entirely.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.
Shelfstatustext: Which shelf to put it on. Leave blank to remove it from the library.One of: reading, plan_to_read (Plan to read), completed, on_hold (On hold), dropped, re_reading (Re-reading).

Outputs

manga_idtext
statustext: The shelf it is now on, or null if removed.

Example output

{
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b",
  "status": "reading"
}

Unfollow custom list

Stop following a custom list.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.

Outputs

followingtrue/false
list_idtext

Example output

{
  "following": false,
  "list_id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d"
}

Unfollow manga

Stop following a manga.

Inputs

Manga IDmanga_idtextRequired: The manga's id. Take it from a Search MangaDex step, or copy it out of a mangadex.org/title/... link.

Outputs

followingtrue/false
manga_idtext

Example output

{
  "following": false,
  "manga_id": "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
}

Unfollow scanlation group

Stop following a scanlation group.

Inputs

Scanlation group IDgroup_idtextRequired: The group's id, from a Search MangaDex scanlation groups step.

Outputs

followingtrue/false
group_idtext

Example output

{
  "following": false,
  "group_id": "4ba3a3d6-2c14-4c5a-b0a4-6f4b1e2c4b1a"
}

Update custom list

Rename a custom list, change who can see it, or replace the manga on it. Anything left blank stays as it is.

Inputs

Custom listlist_idtextRequired: Which custom list to use: your own lists and the ones you follow.
New namenametext: Leave blank to keep the current name.
Visibilityvisibilitytext: Leave blank to keep the current visibility.One of: private (Private: only you can see it), public (Public: anyone with the link can see it).
Manga IDsmanga_idslist: Replaces everything on the list. Leave blank to keep the current manga.

Outputs

listobject

Example output

{
  "list": {
    "id": "1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
    "manga_count": 1,
    "manga_ids": [
      "a77742b1-befd-49a4-bff5-1ad4e6b0ef7b"
    ],
    "name": "Weekend reading",
    "owner_id": "cbc32b3c-1e0d-4b2f-9a55-1f4b3c9a1234",
    "url": "https://mangadex.org/list/1b8c0a3d-2f4e-4a6b-9c1d-0e5f7a8b9c0d",
    "version": 1,
    "visibility": "private"
  }
}

ActionsCopy Anchor Link

Add manga to custom listCopy Anchor Link

Inputs

Outputs

Check if followingCopy Anchor Link

Inputs

Outputs

Convert old MangaDex IDsCopy Anchor Link

Inputs

Outputs

Create custom listCopy Anchor Link

Inputs

Outputs

Delete custom listCopy Anchor Link

Inputs

Outputs

Follow custom listCopy Anchor Link

Inputs

Outputs

Follow mangaCopy Anchor Link

Inputs

Outputs

Follow scanlation groupCopy Anchor Link

Inputs

Outputs

Get a random mangaCopy Anchor Link

Inputs

Outputs

Get chapter page imagesCopy Anchor Link

Inputs

Outputs

Get chapter statisticsCopy Anchor Link

Inputs

Outputs

Get cover artCopy Anchor Link

Inputs

Outputs

Get custom listCopy Anchor Link

Inputs

Outputs

Get custom list feedCopy Anchor Link

Inputs

Outputs

Get followed manga feedCopy Anchor Link

Inputs

Outputs

Get manga statisticsCopy Anchor Link

Inputs

Outputs

Get manga volumes and chaptersCopy Anchor Link

Inputs

Outputs

Get MangaDex authorCopy Anchor Link

Inputs

Outputs

Get MangaDex chapterCopy Anchor Link

Inputs

Outputs

Get MangaDex mangaCopy Anchor Link

Inputs

Outputs

Get MangaDex userCopy Anchor Link

Inputs

Outputs

Get read chaptersCopy Anchor Link

Inputs

Outputs

Get read chapters for several mangaCopy Anchor Link

Inputs

Outputs

Get reading historyCopy Anchor Link

Inputs

Outputs

Get reading statusCopy Anchor Link

Inputs

Outputs

Get related mangaCopy Anchor Link

Inputs

Outputs

Actions

Add manga to custom list

Check if following

Convert old MangaDex IDs

Create custom list

Delete custom list

Follow custom list

Follow manga

Follow scanlation group

Get a random manga

Get chapter page images

Get chapter statistics

Get cover art

Get custom list

Get custom list feed

Get followed manga feed

Get manga statistics

Get manga volumes and chapters

Get MangaDex author

Get MangaDex chapter

Get MangaDex manga

Get MangaDex user

Get read chapters

Get read chapters for several manga

Get reading history

Get reading status

Get related manga

Get scanlation group

Get scanlation group statistics

Get similar manga

Get your manga ratings

Get your MangaDex account

List another user's custom lists

List cover art

List followed custom lists

List followed manga

List followed scanlation groups

List followed users

List library shelves

List manga chapters

List MangaDex tags

List report reasons

List your custom lists

List your reports

Mark chapters read or unread

Rate a manga

Remove a manga rating

Remove manga from custom list

Search MangaDex

Search MangaDex authors

Search MangaDex chapters