### API Response Example Source: https://api.mangaupdates.com/ Example of a standard API response, including status, reason, and context for errors. ```APIDOC ## API Response Example ### Description This is an example of a typical JSON response from the API, often used for error reporting. ### Response Example ```json { "status": "string", "reason": "string", "context": { "property1": [ { "index": 0, "errors": [ "string" ] } ], "property2": [ { "index": 0, "errors": [ "string" ] } ] } } ``` ``` -------------------------------- ### User Profile Payload Example Source: https://api.mangaupdates.com/ Example payload for updating or creating a user profile. This includes various fields related to user settings, preferences, and administrative details. ```APIDOC ## User Profile Payload ### Description This is an example of the JSON payload used for user profile operations. ### Request Body Example ```json { "username": "string", "email": "string", "password": "pa$$word", "roles": [ { "role": "string" } ], "new_avatar_id": 0, "gender": "N/A", "birthday": { "month": 0, "day": 0, "year": 0, "as_string": "string", "zodiac": "string" }, "timezone": 0, "signature": "string", "location": "string", "forum_title": "string", "folding_at_home": true, "profile": { "per_page": 0, "invisible": true, "hide_birthday": true, "hide_categories": true, "filter_types": [ "Artbook" ], "upgrade": { "requested": true, "reason": "string" }, "age18_verified": true }, "admin": { "approved": true, "email_approved": true, "upgrade": { "banned": true }, "banned": true } } ``` ``` -------------------------------- ### Series Response Sample Source: https://api.mangaupdates.com/ Example response structure for series-related requests. ```APIDOC ## Series Response Sample ### Response Example ```json { "total_series": 0, "series_list": [ { "title": "string", "series_id": 0, "url": "string", "year": "string", "last_updated": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "genres": [ "string" ], "metadata": { "user_list": { "series": { "id": 0, "url": "string", "title": "string" }, "list_id": 0, "list_type": "string", "list_icon": "string", "status": { "volume": 0, "chapter": 0 }, "priority": 0, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } } } } ], "genre_list": [ { "genre": "string", "count": 0 } ] } ``` ``` -------------------------------- ### GET /v1/aboutus Source: https://api.mangaupdates.com/ Retrieves the description of the site. Requires bearer authentication. ```APIDOC ## GET /v1/aboutus ### Description Returns the description of the site. ### Method GET ### Endpoint https://api.mangaupdates.com/v1/aboutus ### Query Parameters - **unrenderedFields** (boolean) - Optional - Output fields in unrendered form for editing. ### Responses #### Success Response (200) - **description** (string) - Description of the site. ### Response Example ```json { "description": "string" } ``` ``` -------------------------------- ### GET /releases/{id} Source: https://api.mangaupdates.com/ Retrieves details for a specific release by its ID. ```APIDOC ## GET /releases/{id} ### Description Retrieves a specific release by its ID. ### Method GET ### Endpoint https://api.mangaupdates.com/v1/releases/{id} ### Parameters #### Path Parameters - **id** (integer) - Required - Release ID #### Query Parameters - **unrenderedFields** (boolean) - Optional - Output fields in unrendered form for editing. ### Responses #### Success Response (200) Returns the release record. #### Error Response (401) User does not have the correct role. #### Error Response (404) Release not found. ``` -------------------------------- ### Response Samples Source: https://api.mangaupdates.com/ Example response structures for API requests, including success and error cases. ```APIDOC ## Response Samples ### Content Type application/json ### Success Response (200) ```json { "total_hits": 0, "page": 0, "per_page": 0, "topic_results": [ { "record": { "topic_id": 0, "topic": "string", "url": "string", "last_post": { "post_id": 0, "body_excerpt": "string", "topic": { "forum_id": 0, "topic_id": 0, "topic": "string", "topic_url": "string" }, "author": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "stats": { "posts": 0, "views": 0 }, "forum": { "forum_id": 0, "forum_name": "string", "url": "string" }, "is_poll": true, "admin": { "pinned": true, "locked": true, "global": true }, "topic_starter": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "metadata": { "is_subscribed": true, "my_latest_post_in_topic": 0 } } ], "post_results": [ { "record": { "post_id": 0, "body_excerpt": "string", "topic": { "forum_id": 0, "topic_id": 0, "topic": "string", "topic_url": "string" }, "author": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "metadata": { "is_subscribed": true, "my_latest_post_in_topic": 0, "forum_info": { "forum_id": 0, "forum_name": "string", "url": "string" }, "topic_stats": { "posts": 0, "views": 0 } } } ] } ``` ### Error Response (400) ```json { "error": "Bad Request", "message": "Invalid input or parameters." } ``` ``` -------------------------------- ### Successful Response Sample for Listing Topics Source: https://api.mangaupdates.com/ This is a sample JSON response for a successful request (200 OK) to list topics. It includes pagination details and a list of results, each containing record and metadata information. ```json { "total_hits": 0, "page": 0, "per_page": 0, "results": [ { "record": { "topic_id": 0, "topic": "string", "url": "string", "last_post": { "post_id": 0, "body_excerpt": "string", "topic": { "forum_id": 0, "topic_id": 0, "topic": "string", "topic_url": "string" }, "author": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "stats": { "posts": 0, "views": 0 }, "forum": { "forum_id": 0, "forum_name": "string", "url": "string" }, "is_poll": true, "admin": { "pinned": true, "locked": true, "global": true }, "topic_starter": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "metadata": { "first_post": { "post_id": 0, "body": "string", "topic": { "forum_id": 0, "topic_id": 0, "topic": "string", "topic_url": "string" }, "author": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "reply_to": { "post_id": 0, "post_author": { "author_id": 0, "author_name": "string", "url": "string" } }, "last_edit": { "by": "string", "time": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } } } } ] } ``` -------------------------------- ### GET /forums/global Source: https://api.mangaupdates.com/ Retrieves global forum topic records. This endpoint is useful for getting an overview of recent or active discussions across the platform. ```APIDOC ## GET /forums/global ### Description Retrieves global forum topic records. This endpoint is useful for getting an overview of recent or active discussions across the platform. ### Method GET ### Endpoint https://api.mangaupdates.com/v1/forums/global ### Response #### Success Response (200) - **total_hits** (integer) - The total number of topics found. - **page** (integer) - The current page number of the results. - **per_page** (integer) - The number of results per page. - **results** (array) - An array of topic records. - **record** (object) - Represents a single topic record. - **topic_id** (integer) - The unique identifier for the topic. - **topic** (string) - The title of the topic. - **url** (string) - The URL to the topic. - **last_post** (object) - Information about the last post in the topic. - **post_id** (integer) - The unique identifier for the last post. - **body_excerpt** (string) - An excerpt of the last post's body. - **topic** (object) - Information about the topic the post belongs to. - **forum_id** (integer) - The ID of the forum. - **topic_id** (integer) - The ID of the topic. - **topic** (string) - The title of the topic. - **topic_url** (string) - The URL to the topic. - **author** (object) - Information about the author of the last post. - **user_id** (integer) - The unique identifier for the user. - **username** (string) - The username of the author. - **url** (string) - The URL to the author's profile. - **avatar** (object) - Information about the author's avatar. - **id** (integer) - The avatar ID. - **url** (string) - The URL to the avatar. - **height** (integer) - The height of the avatar. - **width** (integer) - The width of the avatar. - **time_joined** (object) - Information about when the user joined. - **timestamp** (integer) - The join date as a Unix timestamp. - **as_rfc3339** (string) - The join date in RFC 3339 format. - **as_string** (string) - The join date as a formatted string. - **signature** (string) - The user's signature. - **forum_title** (string) - The user's forum title. - **folding_at_home** (boolean) - Indicates if the user participates in Folding@home. - **flair** (string) - User flair text. - **profile** (object) - User profile details. - **upgrade** (object) - Information about profile upgrades. - **requested** (boolean) - Whether an upgrade was requested. - **reason** (string) - The reason for the upgrade request. - **stats** (object) - User statistics. - **forum_posts** (integer) - Total number of forum posts. - **added_authors** (integer) - Number of authors added by the user. - **added_groups** (integer) - Number of groups added by the user. - **added_publishers** (integer) - Number of publishers added by the user. - **added_releases** (integer) - Number of releases added by the user. - **added_series** (integer) - Number of series added by the user. - **time_added** (object) - Information about when the post was added. - **timestamp** (integer) - The post date as a Unix timestamp. - **as_rfc3339** (string) - The post date in RFC 3339 format. - **as_string** (string) - The post date as a formatted string. - **stats** (object) - Statistics for the topic. - **posts** (integer) - The total number of posts in the topic. - **views** (integer) - The number of times the topic has been viewed. - **forum** (object) - Information about the forum the topic belongs to. - **forum_id** (integer) - The unique identifier for the forum. - **forum_name** (string) - The name of the forum. - **url** (string) - The URL to the forum. - **is_poll** (boolean) - Indicates if the topic is a poll. - **admin** (object) - Administrative flags for the topic. - **pinned** (boolean) - Whether the topic is pinned. - **locked** (boolean) - Whether the topic is locked. - **global** (boolean) - Whether the topic is global. - **topic_starter** (object) - Information about the user who started the topic. - **user_id** (integer) - The unique identifier for the user. - **username** (string) - The username of the topic starter. - **url** (string) - The URL to the topic starter's profile. - **avatar** (object) - Information about the topic starter's avatar. - **id** (integer) - The avatar ID. - **url** (string) - The URL to the avatar. - **height** (integer) - The height of the avatar. - **width** (integer) - The width of the avatar. - **time_joined** (object) - Information about when the user joined. - **timestamp** (integer) - The join date as a Unix timestamp. - **as_rfc3339** (string) - The join date in RFC 3339 format. - **as_string** (string) - The join date as a formatted string. - **signature** (string) - The user's signature. - **forum_title** (string) - The user's forum title. - **folding_at_home** (boolean) - Indicates if the user participates in Folding@home. - **flair** (string) - User flair text. - **profile** (object) - User profile details. - **upgrade** (object) - Information about profile upgrades. - **requested** (boolean) - Whether an upgrade was requested. - **reason** (string) - The reason for the upgrade request. - **stats** (object) - User statistics. - **forum_posts** (integer) - Total number of forum posts. - **added_authors** (integer) - Number of authors added by the user. - **added_groups** (integer) - Number of groups added by the user. - **added_publishers** (integer) - Number of publishers added by the user. - **added_releases** (integer) - Number of releases added by the user. - **added_series** (integer) - Number of series added by the user. - **time_added** (object) - Information about when the topic was added. - **timestamp** (integer) - The topic creation date as a Unix timestamp. - **as_rfc3339** (string) - The topic creation date in RFC 3339 format. - **as_string** (string) - The topic creation date as a formatted string. - **metadata** (object) - Metadata related to the results. - **first_post** (object) - Information about the first post in a topic. - **post_id** (integer) - The unique identifier for the first post. - **body** (string) - The full body of the first post. - **topic** (object) - Information about the topic the post belongs to. - **forum_id** (integer) - The ID of the forum. - **topic_id** (integer) - The ID of the topic. - **topic** (string) - The title of the topic. - **topic_url** (string) - The URL to the topic. - **author** (object) - Information about the author of the first post. - **user_id** (integer) - The unique identifier for the user. - **username** (string) - The username of the author. - **url** (string) - The URL to the author's profile. - **avatar** (object) - Information about the author's avatar. - **id** (integer) - The avatar ID. - **url** (string) - The URL to the avatar. - **height** (integer) - The height of the avatar. - **width** (integer) - The width of the avatar. - **time_joined** (object) - Information about when the user joined. - **timestamp** (integer) - The join date as a Unix timestamp. - **as_rfc3339** (string) - The join date in RFC 3339 format. - **as_string** (string) - The join date as a formatted string. - **signature** (string) - The user's signature. - **forum_title** (string) - The user's forum title. - **folding_at_home** (boolean) - Indicates if the user participates in Folding@home. - **flair** (string) - User flair text. - **profile** (object) - User profile details. - **upgrade** (object) - Information about profile upgrades. - **requested** (boolean) - Whether an upgrade was requested. - **reason** (string) - The reason for the upgrade request. - **stats** (object) - User statistics. - **forum_posts** (integer) - Total number of forum posts. - **added_authors** (integer) - Number of authors added by the user. - **added_groups** (integer) - Number of groups added by the user. - **added_publishers** (integer) - Number of publishers added by the user. - **added_releases** (integer) - Number of releases added by the user. - **added_series** (integer) - Number of series added by the user. - **reply_to** (object) - Information about the post being replied to. - **post_id** (integer) - The ID of the post being replied to. - **post_author** (object) - Information about the author of the replied-to post. - **author_id** (integer) - The ID of the author. - **author_name** (string) - The name of the author. - **url** (string) - The URL to the author's profile. - **last_edit** (object) - Information about the last edit to the post. - **by** (string) - The user who last edited the post. - **time** (object) - Information about when the post was last edited. - **timestamp** (integer) - The edit date as a Unix timestamp. - **as_rfc3339** (string) - The edit date in RFC 3339 format. - **as_string** (string) - The edit date as a formatted string. - **time_added** (object) - Information about when the first post was added. - **timestamp** (integer) - The post date as a Unix timestamp. - **as_rfc3339** (string) - The post date in RFC 3339 format. - **as_string** (string) - The post date as a formatted string. ### Request Example ```json { "example": "No request body needed for this GET request." } ``` ### Response Example ```json { "total_hits": 0, "page": 0, "per_page": 0, "results": [ { "record": { "topic_id": 0, "topic": "string", "url": "string", "last_post": { "post_id": 0, "body_excerpt": "string", "topic": { "forum_id": 0, "topic_id": 0, "topic": "string", "topic_url": "string" }, "author": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "stats": { "posts": 0, "views": 0 }, "forum": { "forum_id": 0, "forum_name": "string", "url": "string" }, "is_poll": true, "admin": { "pinned": true, "locked": true, "global": true }, "topic_starter": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "metadata": { "first_post": { "post_id": 0, "body": "string", "topic": { "forum_id": 0, "topic_id": 0, "topic": "string", "topic_url": "string" }, "author": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "reply_to": { "post_id": 0, "post_author": { "author_id": 0, "author_name": "string", "url": "string" } }, "last_edit": { "by": "string", "time": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } } } } ] } ``` ``` -------------------------------- ### Retrieve All Questions for a Category Source: https://api.mangaupdates.com/ Returns a list of FAQ questions for a specified category. Requires authentication. ```json [ { "question_id": 0, "question": "string", "answer": "string", "position": 0 } ] ``` -------------------------------- ### Get Specific Conversation API Source: https://api.mangaupdates.com/ Retrieve details for a specific conversation using its ID. Supports an option to get unrendered fields for editing. ```APIDOC ## GET /convo/{id} ### Description Retrieve a specific conversation by its ID. ### Method GET ### Endpoint https://api.mangaupdates.com/v1/convo/{id} ### Parameters #### Path Parameters - **id** (integer) - Required - The ID of the conversation. #### Query Parameters - **unrenderedFields** (boolean) - Optional - If true, outputs fields in unrendered form for editing. ### Response #### Success Response (200) Returns the conversation record. #### Response Example (Response structure for a specific convo record would be detailed here, similar to the search response but for a single convo) #### Error Responses - **404** - Convo not found. ``` -------------------------------- ### Request Sample for Adding a Custom User List Source: https://api.mangaupdates.com/ This is a sample JSON payload for adding a new custom user list. It includes fields for title, description, type, icon, and various display options. ```json { "title": "string", "description": "string", "type": "read", "icon": "string", "options": { "public": true, "sort": "title", "show_rating": true, "show_status": true, "show_comment": "link", "show_per_page": 0, "show_latest_chapter": true } } ``` -------------------------------- ### Response Sample for 200 OK Source: https://api.mangaupdates.com/ This is a sample JSON response for a successful operation, detailing series information and metadata. ```json { "total_hits": 0, "page": 0, "per_page": 0, "list": { "list_id": 0, "title": "string", "description": "string", "type": "read", "icon": "string", "custom": true, "options": { "public": true, "sort": "title", "show_rating": true, "show_status": true, "show_comment": "link", "show_per_page": 0, "show_latest_chapter": true } }, "results": [ { "record": { "series": { "id": 0, "url": "string", "title": "string" }, "list_id": 0, "list_type": "string", "list_icon": "string", "status": { "volume": 0, "chapter": 0 }, "priority": 0, "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" } }, "metadata": { "series": { "series_id": 0, "title": "string", "url": "string", "description": "string", "image": { "url": { "original": "string", "thumb": "string" }, "height": 0, "width": 0 }, "type": "Artbook", "year": "string", "bayesian_rating": 0, "rating_votes": 0, "genres": [ { "genre": "string" } ], "latest_chapter": 0, "rank": { "position": { "week": 0, "month": 0, "three_months": 0, "six_months": 0, "year": 0 }, "old_position": { "week": 0, "month": 0, "three_months": 0, "six_months": 0, "year": 0 }, "lists": { "reading": 0, "wish": 0, "complete": 0, "unfinished": 0, "custom": 0 } }, "last_updated": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "admin": { "added_by": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "approved": true } }, "user_rating": 0 } } ] } ``` -------------------------------- ### Get Specific FAQ Question Response Source: https://api.mangaupdates.com/ Returns a single FAQ question record for a given category and question ID. The `unrenderedFields` query parameter can be used to get fields in an unrendered form for editing. ```json { "question_id": 0, "question": "string", "answer": "string", "position": 0 } ``` -------------------------------- ### 200 OK Response Sample for Release Details Source: https://api.mangaupdates.com/ This JSON structure represents a successful retrieval of release information. It includes details like title, volume, chapter, group information, release date, and administrative data. ```json { "id": 0, "title": "string", "volume": "string", "chapter": "string", "groups": [ { "name": "string", "group_id": 0, "url": "string" } ], "release_date": "string", "download_notes": "string", "comment": "string", "time_added": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "admin": { "approved": true, "archived": true, "added_by": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } } } } ``` -------------------------------- ### GET /poll Source: https://api.mangaupdates.com/ Retrieves the active poll. ```APIDOC ## GET /poll ### Description Get the active poll. ### Method GET ### Endpoint /poll ### Responses #### Success Response (200) - **active** (boolean) - Indicates if the poll is currently active. - **question** (string) - The question of the poll. - **answers** (array) - An array of poll answers, each with an ID, the answer text, and the total votes. - **total_votes** (integer) - The total number of votes cast for the poll. #### Response Example ```json { "active": true, "question": "string", "answers": [ { "answer_id": 0, "answer": "string", "total": 0 } ], "total_votes": 0 } ``` ``` -------------------------------- ### GET /misc/stats Source: https://api.mangaupdates.com/ Retrieves various site statistics. ```APIDOC ## GET /misc/stats ### Description Show various site stats. ### Method GET ### Endpoint /misc/stats ### Responses #### Success Response (200) - **total_users** (integer) - The total number of users on the site. - **latest_user** (object) - Information about the most recently joined user. - **total_forum_topics** (integer) - The total number of forum topics. - **total_forum_posts** (integer) - The total number of forum posts. #### Response Example ```json { "total_users": 0, "latest_user": { "user_id": 0, "username": "string", "url": "string", "avatar": { "id": 0, "url": "string", "height": 0, "width": 0 }, "time_joined": { "timestamp": 0, "as_rfc3339": "2019-08-24T14:15:22Z", "as_string": "string" }, "signature": "string", "forum_title": "string", "folding_at_home": true, "flair": "staff", "profile": { "upgrade": { "requested": true, "reason": "string" } }, "stats": { "forum_posts": 0, "added_authors": 0, "added_groups": 0, "added_publishers": 0, "added_releases": 0, "added_series": 0 } }, "total_forum_topics": 0, "total_forum_posts": 0 } ``` ``` -------------------------------- ### GET /v1/forums/popular Source: https://api.mangaupdates.com/ Retrieves a list of popular forums on MangaUpdates. ```APIDOC ## GET /v1/forums/popular ### Description Retrieves a list of popular forums on MangaUpdates. ### Method GET ### Endpoint /v1/forums/popular ### Parameters ### Request Example ### Response #### Success Response (200) - **forums** (array) - List of forums - **forum_id** (integer) - The ID of the forum - **forum_name** (string) - The name of the forum - **url** (string) - The URL to the forum #### Response Example { "forums": [ { "forum_id": 1, "forum_name": "General Discussion", "url": "https://www.mangaupdates.com/forum.html?id=1" } ] } ```