MangaUpdates

MangaUpdates API

This API powers our website. Most API functions are public and do not require an account. For user-based functions, you must register an account. Currently,…

Media & content#anime

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

This API powers our website.
Most API functions are public and do not require an account. For user-based functions, you must register an account.
Currently, user registration must be done through our main website and is disabled via this API.

Download OpenAPI Specification: [openapi.yaml](openapi.yaml)

Please contact us at the following emails if you have questions:

  • lambchopsil@mangaupdates.com
  • manick@mangaupdates.com

Warranties

MangaUpdates makes no warranties about service availability, correctness of the data, or anything else. The service is provided as is, and may change at any time.

Acceptable Use Policy

  • You will credit MangaUpdates when using data provided by this API.
  • You will use reasonable spacing between requests so as not to overwhelm the MangaUpdates servers, and employ caching mechanisms when accessing data.
  • You will NOT use MangaUpdates data or API in a way that will:
  • Deceive or defraud users
  • Assist or perform an illegal action
  • Create spam
  • Damage the database

We reserve the right to change this policy at any time.

Endpoints 249

aboutus

  • POSTadd a category/aboutus/category
  • GETreturns a single category/aboutus/category/:category_id
  • DELETEremove a category/aboutus/category/:category_id
  • PATCHupdate a category/aboutus/category/:category_id
  • GETreturns categories and users/aboutus/users
  • GETreturns description of site/aboutus
  • POSTupdate description of site/aboutus
  • POSTreorder aboutus/aboutus/reorder
  • POSTadd a user to a category/aboutus/category/:category_id/users
  • DELETEremove a user from a category/aboutus/category/:category_id/users/:entry_id

account

  • GETretrieve the public captcha key/account/captcha
  • POSTconfirm deletion of your account/account/delete/confirm/:auth_hash
  • POSTdelete your account/account/delete/:captcha_response
  • POSTupdate a password change using an auth hash/account/forgotpass/confirm/:auth_hash
  • POSTsend a forgotten password email/account/forgotpass/:captcha_response
  • PUTcreate a session token/account/login
  • PUTcreate a session token as a cookie/account/loginWithCookie
  • POSTremove a session token/account/logout
  • GETpreview what will be unsubscribed (no auth required)/account/notifications/unsubscribe/:token
  • POSTconfirm and execute unsubscribe (no auth required)/account/notifications/unsubscribe/:token
  • GETget the profile for the current user/account/profile
  • GETrefresh session token cookie/account/refresh
  • POSTconfirm a new member registration/account/register/confirm/:auth_hash
  • POSTregister a new member/account/register/:captcha_response
  • POSTsend an auth email to a user/account/resendauth/:id
  • POSTsend a forgotten password email to a user/account/sendforgot/:id

authors

  • POSTadd an author/authors
  • GETget a specific author/authors/:id
  • DELETEdelete an author/authors/:id
  • PATCHupdate an author/authors/:id
  • GETget locks for a specific author/authors/:id/locks
  • POSTlock a field of an author/authors/:id/locks/:item/lock
  • POSTunlock a field of an author/authors/:id/locks/:item/unlock
  • POSTsearch authors/authors/search
  • POSTget the list of series for a specific author/authors/:id/series
  • POSTupdate the image of an author/authors/:id/image
  • DELETEdelete the image of an author/authors/:id/image

categories

  • POSTcombine two categories across the database/categories/bulk/combine
  • POSTdelete a category across the database/categories/bulk/delete
  • POSTfind a category by prefix/categories/findByPrefix
  • POSTfind a category by name/categories/findByExact
  • POSTsearch categories/categories/search

convo

  • POSTadd an convo/convo
  • POSTabandon convos in bulk/convo/bulk/abandon
  • POSTdelete convos in bulk/convo/bulk/delete
  • GETget a specific convo/convo/:id
  • DELETEdelete a convo/convo/:id
  • PATCHupdate a convo/convo/:id
  • GETreturn whether the user is ignored/convo/ignore/:user_id
  • POSTignore a user/convo/ignore/:user_id
  • DELETEremove ignore for a user/convo/ignore/:user_id
  • GETdisplay unread messages/convo/inbox
  • GETretrieve number of unread messages/convo/inbox/count
  • POSTdisplay sent messages/convo/sent
  • POSTdisplay received (and read) messages/convo/received
  • POSTadd a message to a convo/convo/:id/messages
  • POSTlist convo messages/convo/:id/messages/list
  • GETget a specific convo message/convo/:id/messages/:message_id
  • PATCHupdate a convo message/convo/:id/messages/:message_id
  • GETget a specific convo message location/convo/:id/messages/:message_id/location
  • POSTsearch convo/convo/:id/messages/search
  • POSTabandon a convo/convo/:id/abandon
  • POSTinvite a user to a convo/convo/:id/invite
  • POSTjoin a convo/convo/:id/join
  • POSTkick a user from a convo/convo/:id/kick/:user_id
  • GETget list of convo participants/convo/:id/participants
  • POSTsearch convo/convo/search

faq

  • GETretrieve all categories and questions/faq
  • POSTadd a faq category/faq
  • GETget a specific category/faq/:category_id
  • DELETEdelete a faq category/faq/:category_id
  • PATCHupdate a faq category/faq/:category_id
  • GETretrieve all quesitons for a category/faq/:category_id/questions
  • POSTadd a faq question/faq/:category_id/questions
  • GETget a specific question for a category/faq/:category_id/questions/:question_id
  • DELETEdelete an faq/faq/:category_id/questions/:question_id
  • PATCHupdate a faq question/faq/:category_id/questions/:question_id
  • POSTreorder faq/faq/reorder

forum

  • PUTadd a forum admin/forums/:forum_id/admins/:user_id
  • DELETEremove a forum admin/forums/:forum_id/admins/:user_id
  • GETretrieve a forum/forums/:forum_id
  • POSTadd a forum topic/forums/:forum_id
  • POSTshow forum admin log/forums/log
  • GETshow forum categories and forums/forums
  • GETshow popular forums/forums/popular
  • GETlist posts in topic that I made/forums/:forum_id/topics/:topic_id/my_posts
  • POSTlist posts in topic/forums/:forum_id/topics/:topic_id/list
  • POSTlist topics/forums/:forum_id/list
  • GETlist global topics/forums/global
  • GETlookup a series to find the forum id/forums/lookup/series/:series_id
  • GETlookup a topic to find the forum id/forums/lookup/topic/:topic_id
  • GETlookup a post to find the forum and topic id/forums/lookup/post/:post_id
  • GETretrieve temporary poll images/forums/temp_poll_images
  • POSTadd a temporary poll image/forums/temp_poll_images
  • PATCHupdate a forum topic poll (if present)/forums/:forum_id/topics/:topic_id/poll
  • POSTadd a vote to a forum poll/forums/:forum_id/topics/:topic_id/poll/vote/:choice_id
  • GETretrieve my vote from the poll/forums/:forum_id/topics/:topic_id/poll/vote
  • GETretrieve a forum topic/forums/:forum_id/topics/:topic_id
  • POSTadd a forum post/forums/:forum_id/topics/:topic_id
  • DELETEdelete a topic/forums/:forum_id/topics/:topic_id
  • PATCHupdate a forum topic/forums/:forum_id/topics/:topic_id
  • GETretrieve a forum post/forums/:forum_id/topics/:topic_id/posts/:post_id
  • DELETEdelete a post/forums/:forum_id/topics/:topic_id/posts/:post_id
  • PATCHupdate a forum post/forums/:forum_id/topics/:topic_id/posts/:post_id
  • POSTreport a forum post/forums/:forum_id/topics/:topic_id/posts/:post_id/report
  • DELETEdelete a post report/forums/:forum_id/topics/:topic_id/posts/:post_id/report
  • GETshow reported posts/forums/report
  • GETretrieve a forum post location within topic/forums/:forum_id/topics/:topic_id/posts/:post_id/location
  • POSTsearch forum/forums/search
  • POSTsearch specific forum/forums/:forum_id/search
  • POSTsearch specific topic/forums/:forum_id/topics/:topic_id/search
  • GETshow warn history for a user/forums/warn/:user_id/history
  • GETgets the current warn status for user/forums/warn/:user_id
  • PUTupdate a user warn level/forums/warn/:user_id

genre

  • GETget genres/genres
  • POSTadd a genre/genres
  • GETget genres/genres/:id
  • DELETEdelete a genre/genres/:id
  • PATCHupdate a genre/genres/:id

groups

  • POSTadd an group/groups
  • GETget a specific group/groups/:id
  • DELETEdelete a group/groups/:id
  • PATCHupdate an group/groups/:id
  • POSTreject and delete a group/groups/:id/reject
  • POSTsearch groups/groups/search
  • GETget the list of series and release frequency for a specific group/groups/:id/series

lists

  • GETretrieve list of user lists/lists
  • POSTadd a custom user list/lists
  • GETretrieve list metadata and options/lists/:id
  • DELETEremove a custom list/lists/:id
  • PATCHupdate a user list/lists/:id
  • GETretrieve list of user lists/lists/public/:user_id
  • GETretrieve stats for user public lists/lists/public/:user_id/stats
  • POSTsearch lists/lists/public/:user_id/search/:id
  • POSTsearch lists/lists/:id/search
  • POSTadd a series to a list/lists/series
  • POSTadd a list of series to a list/lists/:id/series/bulk
  • POSTremove a series from a list/lists/series/delete
  • GETretrieve list series item/lists/series/:series_id
  • POSTupdate a series list item/lists/series/update
  • GETretrieve users who have similar interests based on series/lists/similar/:list_name/:series_id

misc

  • GETget the current time/misc/time
  • GETlist online users/misc/online
  • GETget the status of a bulk transaction/misc/slow-transaction-status/:transaction_id
  • GETshow various site stats/misc/stats

poll

  • GETget the active poll/poll
  • POSTadd a new poll/poll
  • DELETEarchive the active poll/poll
  • POSTsearch archived polls/poll/search
  • POSTvote in a poll/poll/vote
  • POSTvote in a poll answer/poll/vote/:answer_id
  • GETget information about whether the user has voted/poll/vote/status

publishers

  • POSTadd an publisher/publishers
  • GETget a specific publisher/publishers/:id
  • DELETEdelete a publisher/publishers/:id
  • PATCHupdate a publisher/publishers/:id
  • POSTsearch publishers/publishers/search
  • GETget the list of series for a specific publisher/publishers/:id/series
  • GETget the list of series for a specific publication/publishers/publication?pubname=string

releases

  • POSTadd an release/releases
  • GETget a specific release/releases/:id
  • DELETEdelete a release/releases/:id
  • PATCHupdate an release/releases/:id
  • POSTsearch releases to moderate/releases/moderate
  • GETshow releases by day/releases/days
  • GETreleases rss feed/releases/rss
  • POSTsearch releases/releases/search

reviews

  • POSTadd a review/reviews
  • POSTadd a review comment/reviews/:id/comments
  • GETget a specific review comment/reviews/:id/comments/:comment_id
  • DELETEdelete a review comment/reviews/:id/comments/:comment_id
  • PATCHupdate a review comment/reviews/:id/comments/:comment_id
  • POSTmoderate review comments/reviews/comments/moderation
  • POSTsearch review comments/reviews/:id/comments/search
  • GETget a specific review/reviews/:id
  • DELETEdelete a review/reviews/:id
  • PATCHupdate a review/reviews/:id
  • POSTsearch reviews/reviews/search

series

  • POSTadd an series/series
  • POSTcombine two series categories/series/:id/categories/combine
  • POSTdeletes a series category/series/:id/categories/delete
  • POSTrenames a series category/series/:id/categories/rename
  • GETget category votes for the current user/series/:id/categories/votes
  • POSTadd a vote for a category on a series/series/:id/categories/vote
  • POSTremove series category vote for user/series/:id/categories/vote/delete
  • POSTadd a series comment/series/:id/comments
  • GETget a specific series comment/series/:id/comments/:comment_id
  • DELETEdelete a series comment/series/:id/comments/:comment_id
  • PATCHupdate a series comment/series/:id/comments/:comment_id
  • POSTmoderate series comments/series/comments/moderation
  • POSTreport a series comment/series/:id/comments/:comment_id/report
  • GETget my series comment/series/:id/comments/my_comment
  • GETget a specific series comment location/series/:id/comments/:comment_id/location
  • POSTsearch series comments/series/:id/comments/search
  • PUTset usefulness of a series comment/series/:id/comments/:comment_id/useful
  • DELETEremove usefulness of a series comment/series/:id/comments/:comment_id/useful
  • GETget a specific series/series/:id
  • DELETEdelete a series/series/:id
  • PATCHupdate an series/series/:id
  • GETget the list of groups scanlating a specific series/series/:id/groups
  • POSTsearch series history/series/:id/history
  • GETget a specific series lock/series/:id/locks
  • POSTlock a field of an series/series/:id/locks/:item/lock
  • POSTunlock a field of an series/series/:id/locks/:item/unlock
  • GETget a specific series rank location/series/:id/rank/:type
  • GETget a specific series rating for a user/series/:id/rating
  • PUTupdate the user rating for a series/series/:id/rating
  • DELETEdelete a series rating for a user/series/:id/rating
  • GETget a the series rating rainbow/series/:id/ratingrainbow
  • GETreleases rss feed for a specific series/series/:id/rss
  • POSTsearch series/series/search
  • POSTupdate the image of an series/series/:id/image
  • DELETEdelete the image of an series/series/:id/image

members

  • POSTadd a member/members
  • GETsearch change requests for a specific user/members/:id/requests
  • POSTadd a change request/members/:id/requests
  • GETget change requests for a specific user/members/:id/requests/:request_id
  • DELETEadd a change request/members/:id/requests/:request_id
  • PATCHupdate a change request/members/:id/requests/:request_id
  • GETget a specific members/members/:id
  • DELETEdelete a member/members/:id
  • PATCHupdate a member/members/:id
  • GETget genre filters for a specific user/members/:id/genre/filters
  • POSTfilter a genre for a user/members/:id/genre/:genre_id/filter
  • DELETEremove a filter for a genre for a user/members/:id/genre/:genre_id/filter
  • GETget highlights for a specific user/members/:id/genre/highlights
  • POSThighlight a genre for a user/members/:id/genre/:genre_id/highlight
  • DELETEremove a highlight for a genre for a user/members/:id/genre/:genre_id/highlight
  • POSTreset genre highlights and filters for a user/members/:id/genre/reset
  • GETget group filters for a specific user/members/:id/group/filters
  • POSTfilter a group for a user/members/:id/group/:group_id/filter
  • DELETEremove a filter for a group for a user/members/:id/group/:group_id/filter
  • GETget notification preferences for a specific user/members/:id/notification-preferences
  • PUTupdate all notification preferences for a specific user/members/:id/notification-preferences
  • GETget notifications for a specific user/members/:id/notifications
  • GETget unread notification count for a specific user/members/:id/notifications/unread-count
  • POSTmark notifications as read for a specific user/members/:id/notifications/mark-read
  • GETget avatars for a specific user/members/:id/avatars
  • POSTsearch members/members/search
  • GETget a specific member sessions if they exists/members/:id/sessions
  • DELETEdelete all a members sessions/members/:id/sessions
  • GETget topic subscriptions for a specific user/members/:id/topics
  • GETget a subscription to a specific topic for a user/members/:id/topics/:topic_id
  • POSTadd a topic subscription for a user/members/:id/topics/:topic_id
  • DELETEremove a topic subscription for a user/members/:id/topics/:topic_id
  • POSTadd a new member avatar/members/:id/avatar
  • DELETEdelete a member avatar/members/:id/avatar/:avatar_id
  • POSTupgrade a member/members/:id/upgrade/approve
  • POSTreject a member upgrade/members/:id/upgrade/reject

API details

Base URL
https://api.mangaupdates.com/v1
Authentication
A bearer token in the Authorization header
Operations
249 operations on 183 pathsPOST 105GET 84DELETE 33PATCH 20PUT 7
Main resources
forum 36members 36series 35convo 25account 16lists 15authors 11faq 11reviews 11aboutus 10
Response formats
application/json application/xml
Description format
OpenAPI 3.0.0, API version 1.0.0

How to test the MangaUpdates API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the MangaUpdates API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “add a category” (POST /aboutus/category), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the MangaUpdates API?

This API powers our website. Most API functions are public and do not require an account. For user-based functions, you must register an account. Currently,… It is listed under Media & content and has 249 endpoints.

Who publishes the MangaUpdates API?

It is listed from MangaUpdates's public API description (an OpenAPI document), not published by MangaUpdates on Swastik Codes. Anyone who controls mangaupdates.com can claim the profile by adding a DNS TXT record.

What is the base URL of the MangaUpdates API?

Requests go to https://api.mangaupdates.com/v1. Endpoint paths are added to this base URL.

How do I authenticate with the MangaUpdates API?

With A bearer token in the Authorization header.

How many endpoints does the MangaUpdates API have?

249 operations on 183 paths (105 POST, 84 GET, 33 DELETE, 20 PATCH, 7 PUT). The largest groups are forum, members, series, convo.

Is forking the MangaUpdates API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.