Data Models¶
Warning
Those models may or may note comply with MAL API official documentation. For more info refer to Inconsistencies
Universal¶
-
class
malclient.Node¶ -
Object representing simplified anime/manga info
Show JSON schema
json{ "title": "Node", "description": "Object representing simplified anime/manga info", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" } }, "required": [ "id", "title" ], "definitions": { "Asset": { "title": "Asset", "description": "Asset object, commonly representing an image with two resolutions", "type": "object", "properties": { "large": { "title": "Large", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "medium": { "title": "Medium", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "medium" ] } } }- Fields
id (int)title (str)main_picture (Optional[malclient.Datamodels.models.Asset])
-
class
malclient.Asset¶ -
Asset object, commonly representing an image with two resolutions
Show JSON schema
json{ "title": "Asset", "description": "Asset object, commonly representing an image with two resolutions", "type": "object", "properties": { "large": { "title": "Large", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "medium": { "title": "Medium", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "medium" ] }- Fields
large (Optional[pydantic.networks.HttpUrl])medium (pydantic.networks.HttpUrl)
-
class
malclient.Genre¶ -
Anime or Manga Genre
Show JSON schema
json{ "title": "Genre", "description": "Anime or Manga Genre", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }- Fields
id (int)name (str)
-
class
malclient.Relation¶ -
Object representing relations between anime and/or manga
Show JSON schema
json{ "title": "Relation", "description": "Object representing relations between anime and/or manga", "type": "object", "properties": { "node": { "$ref": "#/definitions/Node" }, "relation_type": { "title": "Relation Type", "type": "string" }, "relation_type_formatted": { "title": "Relation Type Formatted", "type": "string" } }, "required": [ "node", "relation_type", "relation_type_formatted" ], "definitions": { "Asset": { "title": "Asset", "description": "Asset object, commonly representing an image with two resolutions", "type": "object", "properties": { "large": { "title": "Large", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "medium": { "title": "Medium", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "medium" ] }, "Node": { "title": "Node", "description": "Object representing simplified anime/manga info", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" } }, "required": [ "id", "title" ] } } }- Fields
node (malclient.Datamodels.models.Node)relation_type (str)relation_type_formatted (str)
-
class
malclient.RelationType(value)¶ -
Enumerator representing possible relation types between anime and/or manga:
SEQUEL - Sequel
PREQUEL - Prequel
ALT_SETTING - Alternative Setting
ALT_VERSION - Alternative Version
SIDE_STORY - Side Story
PARENT_STORY - Parent Story
SUMMARY - Summary
FULL_STORY - Full Story
SPIN_OFF - Spin-Off
CHARACTER - Character
OTHER - Other
-
class
malclient.Nsfw(value)¶ -
Enumerator representing nsfw stages:
WHITE - White
GRAY - Gray
BLACK - Black
-
class
malclient.Recommendation¶ -
Representation of anime or manga recommendation
Show JSON schema
json{ "title": "Recommendation", "description": "Representation of anime or manga recommendation", "type": "object", "properties": { "num_recommendations": { "title": "Num Recommendations", "type": "integer" }, "node": { "$ref": "#/definitions/Node" } }, "required": [ "num_recommendations", "node" ], "definitions": { "Asset": { "title": "Asset", "description": "Asset object, commonly representing an image with two resolutions", "type": "object", "properties": { "large": { "title": "Large", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "medium": { "title": "Medium", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "medium" ] }, "Node": { "title": "Node", "description": "Object representing simplified anime/manga info", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" } }, "required": [ "id", "title" ] } } }- Fields
num_recommendations (int)node (malclient.Datamodels.models.Node)
Anime Specific¶
-
class
malclient.AnimeObject¶ -
Model of anime fetched from myanimelist
Show JSON schema
json{ "title": "AnimeObject", "description": "Model of anime fetched from myanimelist", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" }, "alternative_titles": { "title": "Alternative Titles", "type": "object" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "end_date": { "title": "End Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "synopsis": { "title": "Synopsis", "type": "string" }, "mean": { "title": "Mean", "type": "number" }, "rank": { "title": "Rank", "type": "integer" }, "popularity": { "title": "Popularity", "type": "integer" }, "num_list_users": { "title": "Num List Users", "type": "integer" }, "num_scoring_users": { "title": "Num Scoring Users", "type": "integer" }, "nsfw": { "$ref": "#/definitions/Nsfw" }, "genres": { "title": "Genres", "type": "array", "items": { "$ref": "#/definitions/Genre" } }, "created_at": { "title": "Created At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "media_type": { "$ref": "#/definitions/AnimeType" }, "status": { "$ref": "#/definitions/AnimeStatus" }, "my_list_status": { "$ref": "#/definitions/MyAnimeListStatus" }, "pictures": { "title": "Pictures", "type": "array", "items": { "$ref": "#/definitions/Asset" } }, "background": { "title": "Background", "type": "string" }, "related_anime": { "title": "Related Anime", "type": "array", "items": { "$ref": "#/definitions/Relation" } }, "related_manga": { "title": "Related Manga", "type": "array", "items": { "$ref": "#/definitions/Relation" } }, "recommendations": { "title": "Recommendations", "type": "array", "items": { "$ref": "#/definitions/Recommendation" } }, "list_status": { "$ref": "#/definitions/MyAnimeListStatus" }, "ranking": { "$ref": "#/definitions/RankingObject" }, "num_episodes": { "title": "Num Episodes", "type": "integer" }, "start_season": { "$ref": "#/definitions/AnimeSeason" }, "broadcast": { "$ref": "#/definitions/Broadcast" }, "source": { "title": "Source", "anyOf": [ { "$ref": "#/definitions/AnimeSource" }, { "type": "string" } ] }, "average_episode_duration": { "title": "Average Episode Duration", "type": "integer" }, "rating": { "$ref": "#/definitions/Rating" }, "studios": { "title": "Studios", "type": "array", "items": { "$ref": "#/definitions/Studio" } }, "statistics": { "$ref": "#/definitions/Statistics" }, "videos": { "title": "Videos", "type": "array", "items": { "$ref": "#/definitions/Video" } } }, "required": [ "id", "title" ], "definitions": { "Asset": { "title": "Asset", "description": "Asset object, commonly representing an image with two resolutions", "type": "object", "properties": { "large": { "title": "Large", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "medium": { "title": "Medium", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "medium" ] }, "Nsfw": { "title": "Nsfw", "description": "Enumerator representing nsfw stages:\n\n* **WHITE** - White\n* **GRAY** - Gray\n* **BLACK** - Black", "enum": [ "white", "gray", "black" ] }, "Genre": { "title": "Genre", "description": "Anime or Manga Genre", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }, "AnimeType": { "title": "AnimeType", "description": "Enumerator representing anime type:\n\n* **Unknown**\n* **TV** - Streamed in Japanese TV\n* **OVA** - Original Video Animation\n* **Movie** - Animated Movie\n* **Special** - Special for an anime\n* **ONA** - Original Net Anime (f.e. Netflix Originals)\n* **Music** - Music Anime", "enum": [ "unknown", "tv", "ova", "movie", "special", "ona", "music" ] }, "AnimeStatus": { "title": "AnimeStatus", "description": "Enumerating representing current anime status\n\n* **FINISHED** - Finished Airing\n* **AIRING** - Currently Airing\n* **NOT_AIRED** - Not Yet Aired", "enum": [ "finished_airing", "currently_airing", "not_yet_aired" ] }, "MyAnimeListStatus": { "title": "MyAnimeListStatus", "description": "Status from users anime list", "type": "object", "properties": { "score": { "title": "Score", "type": "integer" }, "status": { "title": "Status", "type": "string" }, "is_rewatching": { "title": "Is Rewatching", "type": "boolean" }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "num_episodes_watched": { "title": "Num Episodes Watched", "type": "integer" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "finish_date": { "title": "Finish Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "priority": { "title": "Priority", "type": "integer" }, "num_times_rewatched": { "title": "Num Times Rewatched", "type": "integer" }, "rewatch_value": { "title": "Rewatch Value", "type": "integer" }, "tags": { "title": "Tags", "type": "array", "items": { "type": "string" } }, "comments": { "title": "Comments", "type": "string" } }, "required": [ "score", "status", "is_rewatching", "updated_at", "num_episodes_watched" ] }, "Node": { "title": "Node", "description": "Object representing simplified anime/manga info", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" } }, "required": [ "id", "title" ] }, "Relation": { "title": "Relation", "description": "Object representing relations between anime and/or manga", "type": "object", "properties": { "node": { "$ref": "#/definitions/Node" }, "relation_type": { "title": "Relation Type", "type": "string" }, "relation_type_formatted": { "title": "Relation Type Formatted", "type": "string" } }, "required": [ "node", "relation_type", "relation_type_formatted" ] }, "Recommendation": { "title": "Recommendation", "description": "Representation of anime or manga recommendation", "type": "object", "properties": { "num_recommendations": { "title": "Num Recommendations", "type": "integer" }, "node": { "$ref": "#/definitions/Node" } }, "required": [ "num_recommendations", "node" ] }, "RankingObject": { "title": "RankingObject", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "rank": { "title": "Rank", "type": "integer" }, "previous_rank": { "title": "Previous Rank", "type": "integer" } }, "required": [ "rank" ] }, "AnimeSeason": { "title": "AnimeSeason", "description": "Representation of anime season (f.e. winter 2022)", "type": "object", "properties": { "year": { "title": "Year", "type": "integer" }, "season": { "title": "Season", "type": "string" } }, "required": [ "year", "season" ] }, "Broadcast": { "title": "Broadcast", "description": "Object representing date of episode broadcast (in JST)", "type": "object", "properties": { "day_of_the_week": { "title": "Day Of The Week", "type": "string" }, "start_time": { "title": "Start Time", "type": "string", "format": "time" } }, "required": [ "day_of_the_week" ] }, "AnimeSource": { "title": "AnimeSource", "description": "Enumerator representing source of anime\n\n* **OTHER** - Other\n* **ORIGINAL** - Original\n* **MANGA** - Manga\n* **MANGA_4_KOMA** - 4-Koma, comedic manga format\n* **WEB_MANGA** - Web Manga\n* **WEB_NOVEL** - Web Novel\n* **DIGITAL_MANGA** - Digital Manga\n* **NOVEL** - Novel\n* **LIGHT_NOVEL** - Light Novel\n* **VISUAL_NOVEL** - Text-based video game\n* **GAME** - Game\n* **CARD_GAME** - Card Game\n* **BOOK** - Book\n* **PICTURE_BOOK** - Picture Book\n* **RADIO** - Radio\n* **MUSIC** - Music\n* **MIXED_MEDIA** - Mixed Media", "enum": [ "other", "original", "manga", "4_koma_manga", "web_manga", "web_novel", "digital_manga", "novel", "light_novel", "visual_novel", "game", "card_game", "book", "picture_book", "radio", "music", "mixed_media" ] }, "Rating": { "title": "Rating", "description": "Rating of shows provided by myanimelist:\n\n* **G** - All Ages\n* **PG** - Children\n* **PG_13** - Teens 13 and Older\n* **R** - 17+ (violence & profanity)\n* **RR** - Profanity & Mild Nudity\n* **Rx** - Hentai", "enum": [ "g", "pg", "pg_13", "r", "r+", "rx" ] }, "Studio": { "title": "Studio", "description": "Representation of anime studio", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }, "Statistics": { "title": "Statistics", "description": "Object representing list statistics of anime on MAL", "type": "object", "properties": { "num_list_users": { "title": "Num List Users", "type": "integer" }, "watching": { "title": "Watching", "type": "integer" }, "completed": { "title": "Completed", "type": "integer" }, "on_hold": { "title": "On Hold", "type": "integer" }, "dropped": { "title": "Dropped", "type": "integer" }, "plan_to_watch": { "title": "Plan To Watch", "type": "integer" } }, "required": [ "num_list_users", "watching", "completed", "on_hold", "dropped", "plan_to_watch" ] }, "Video": { "title": "Video", "description": "Class containing information about video attached to anime, f.e. PV", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "url": { "title": "Url", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "created_at": { "title": "Created At", "type": "string", "format": "date-time" }, "updated_at": { "title": "Updated At", "type": "string", "format": "date-time" }, "thumbnail": { "title": "Thumbnail", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "id", "title", "url", "created_at", "updated_at", "thumbnail" ] } } }- Fields
media_type (Optional[malclient.Datamodels.enums.AnimeType])status (Optional[malclient.Datamodels.enums.AnimeStatus])my_list_status (Optional[malclient.Datamodels.models.MyAnimeListStatus])num_episodes (Optional[int])start_season (Optional[malclient.Datamodels.models.AnimeSeason])broadcast (Optional[malclient.Datamodels.models.Broadcast])source (Optional[Union[malclient.Datamodels.enums.AnimeSource, str]])average_episode_duration (Optional[int])rating (Optional[malclient.Datamodels.enums.Rating])studios (Optional[list[malclient.Datamodels.models.Studio]])statistics (Optional[malclient.Datamodels.models.Statistics])videos (Optional[list[malclient.Datamodels.models.Video]])list_status (Optional[malclient.Datamodels.models.MyAnimeListStatus])
-
populate(client)¶ -
Send new request and return new object containing full details
- Parameters
client (malclient.Client) – client with which new data will be fetched
- Returns
Fully populated AnimeObject
- Return type
-
class
malclient.AnimeStatus(value)¶ -
Enumerating representing current anime status
FINISHED - Finished Airing
AIRING - Currently Airing
NOT_AIRED - Not Yet Aired
-
class
malclient.AnimeType(value)¶ -
Enumerator representing anime type:
Unknown
TV - Streamed in Japanese TV
OVA - Original Video Animation
Movie - Animated Movie
Special - Special for an anime
ONA - Original Net Anime (f.e. Netflix Originals)
Music - Music Anime
-
class
malclient.Broadcast¶ -
Object representing date of episode broadcast (in JST)
Show JSON schema
json{ "title": "Broadcast", "description": "Object representing date of episode broadcast (in JST)", "type": "object", "properties": { "day_of_the_week": { "title": "Day Of The Week", "type": "string" }, "start_time": { "title": "Start Time", "type": "string", "format": "time" } }, "required": [ "day_of_the_week" ] }- Fields
day_of_the_week (str)start_time (Optional[datetime.time])
-
class
malclient.MyAnimeListStatus¶ -
Status from users anime list
Show JSON schema
json{ "title": "MyAnimeListStatus", "description": "Status from users anime list", "type": "object", "properties": { "score": { "title": "Score", "type": "integer" }, "status": { "title": "Status", "type": "string" }, "is_rewatching": { "title": "Is Rewatching", "type": "boolean" }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "num_episodes_watched": { "title": "Num Episodes Watched", "type": "integer" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "finish_date": { "title": "Finish Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "priority": { "title": "Priority", "type": "integer" }, "num_times_rewatched": { "title": "Num Times Rewatched", "type": "integer" }, "rewatch_value": { "title": "Rewatch Value", "type": "integer" }, "tags": { "title": "Tags", "type": "array", "items": { "type": "string" } }, "comments": { "title": "Comments", "type": "string" } }, "required": [ "score", "status", "is_rewatching", "updated_at", "num_episodes_watched" ] }- Fields
score (int)status (str)is_rewatching (bool)updated_at (Union[datetime.datetime, str])num_episodes_watched (int)start_date (Optional[Union[datetime.date, str]])finish_date (Optional[Union[datetime.date, str]])priority (Optional[int])num_times_rewatched (Optional[int])rewatch_value (Optional[int])tags (Optional[list[str]])comments (Optional[str])
-
class
malclient.Statistics¶ -
Object representing list statistics of anime on MAL
Show JSON schema
json{ "title": "Statistics", "description": "Object representing list statistics of anime on MAL", "type": "object", "properties": { "num_list_users": { "title": "Num List Users", "type": "integer" }, "watching": { "title": "Watching", "type": "integer" }, "completed": { "title": "Completed", "type": "integer" }, "on_hold": { "title": "On Hold", "type": "integer" }, "dropped": { "title": "Dropped", "type": "integer" }, "plan_to_watch": { "title": "Plan To Watch", "type": "integer" } }, "required": [ "num_list_users", "watching", "completed", "on_hold", "dropped", "plan_to_watch" ] }- Fields
num_list_users (int)watching (int)completed (int)on_hold (int)dropped (int)plan_to_watch (int)
-
class
malclient.Rating(value)¶ -
Rating of shows provided by myanimelist:
G - All Ages
PG - Children
PG_13 - Teens 13 and Older
R - 17+ (violence & profanity)
RR - Profanity & Mild Nudity
Rx - Hentai
-
class
malclient.AnimeSeason¶ -
Representation of anime season (f.e. winter 2022)
Show JSON schema
json{ "title": "AnimeSeason", "description": "Representation of anime season (f.e. winter 2022)", "type": "object", "properties": { "year": { "title": "Year", "type": "integer" }, "season": { "title": "Season", "type": "string" } }, "required": [ "year", "season" ] }- Fields
year (int)season (str)
-
class
malclient.Season(value)¶ -
An enumeration.
-
class
malclient.AnimeSource(value)¶ -
Enumerator representing source of anime
OTHER - Other
ORIGINAL - Original
MANGA - Manga
MANGA_4_KOMA - 4-Koma, comedic manga format
WEB_MANGA - Web Manga
WEB_NOVEL - Web Novel
DIGITAL_MANGA - Digital Manga
NOVEL - Novel
LIGHT_NOVEL - Light Novel
VISUAL_NOVEL - Text-based video game
GAME - Game
CARD_GAME - Card Game
BOOK - Book
PICTURE_BOOK - Picture Book
RADIO - Radio
MUSIC - Music
MIXED_MEDIA - Mixed Media
-
class
malclient.Studio¶ -
Representation of anime studio
Show JSON schema
json{ "title": "Studio", "description": "Representation of anime studio", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }- Fields
id (int)name (str)
-
class
malclient.AnimeRankingType(value)¶ -
Representation of possible values for anime ranking type
ALL - Top Anime Series
AIRING - Top Airing Anime
UPCOMING - Top Upcoming Anime
TV - Top TV Anime Series
OVA - Top OVA Anime Series
MOVIE - Top Anime Movies
SPECIAL - Top Anime Specials
POPULAR - Top Anime by Popularity
FAVORITE - Top Favorite Anime
-
class
malclient.SeasonalAnimeSorting(value)¶ -
Representation of seasonal anime sorting
SCORE - Sorted by score
USER_NUM - Sorted by number of users in list
-
class
malclient.MyAnimeListSorting(value)¶ -
Sorting options for User Anime List
LIST_SCORE - Sorted by score given by user
LAST_UPDATE - Sorted by most recently updated
TITLE - Sorted by title
START_DATE - Sorted by broadcast start date
ID - Sorted by ID
Note
This is available only in alpha build of a wrapper
-
class
malclient.Character¶ -
Show JSON schema
json{ "title": "Character", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "first_name": { "title": "First Name", "type": "string" }, "last_name": { "title": "Last Name", "type": "string" }, "role": { "title": "Role", "type": "string" }, "alternative_name": { "title": "Alternative Name", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" }, "biography": { "title": "Biography", "type": "string" }, "pictures": { "title": "Pictures", "type": "array", "items": { "$ref": "#/definitions/Asset" } }, "animeography": { "title": "Animeography", "type": "array", "items": { "$ref": "#/definitions/Animeography" } }, "num_favorites": { "title": "Num Favorites", "type": "integer" } }, "required": [ "id", "first_name", "last_name" ], "definitions": { "Asset": { "title": "Asset", "description": "Asset object, commonly representing an image with two resolutions", "type": "object", "properties": { "large": { "title": "Large", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "medium": { "title": "Medium", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "medium" ] }, "Nsfw": { "title": "Nsfw", "description": "Enumerator representing nsfw stages:\n\n* **WHITE** - White\n* **GRAY** - Gray\n* **BLACK** - Black", "enum": [ "white", "gray", "black" ] }, "Genre": { "title": "Genre", "description": "Anime or Manga Genre", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }, "AnimeType": { "title": "AnimeType", "description": "Enumerator representing anime type:\n\n* **Unknown**\n* **TV** - Streamed in Japanese TV\n* **OVA** - Original Video Animation\n* **Movie** - Animated Movie\n* **Special** - Special for an anime\n* **ONA** - Original Net Anime (f.e. Netflix Originals)\n* **Music** - Music Anime", "enum": [ "unknown", "tv", "ova", "movie", "special", "ona", "music" ] }, "AnimeStatus": { "title": "AnimeStatus", "description": "Enumerating representing current anime status\n\n* **FINISHED** - Finished Airing\n* **AIRING** - Currently Airing\n* **NOT_AIRED** - Not Yet Aired", "enum": [ "finished_airing", "currently_airing", "not_yet_aired" ] }, "MyAnimeListStatus": { "title": "MyAnimeListStatus", "description": "Status from users anime list", "type": "object", "properties": { "score": { "title": "Score", "type": "integer" }, "status": { "title": "Status", "type": "string" }, "is_rewatching": { "title": "Is Rewatching", "type": "boolean" }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "num_episodes_watched": { "title": "Num Episodes Watched", "type": "integer" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "finish_date": { "title": "Finish Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "priority": { "title": "Priority", "type": "integer" }, "num_times_rewatched": { "title": "Num Times Rewatched", "type": "integer" }, "rewatch_value": { "title": "Rewatch Value", "type": "integer" }, "tags": { "title": "Tags", "type": "array", "items": { "type": "string" } }, "comments": { "title": "Comments", "type": "string" } }, "required": [ "score", "status", "is_rewatching", "updated_at", "num_episodes_watched" ] }, "Node": { "title": "Node", "description": "Object representing simplified anime/manga info", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" } }, "required": [ "id", "title" ] }, "Relation": { "title": "Relation", "description": "Object representing relations between anime and/or manga", "type": "object", "properties": { "node": { "$ref": "#/definitions/Node" }, "relation_type": { "title": "Relation Type", "type": "string" }, "relation_type_formatted": { "title": "Relation Type Formatted", "type": "string" } }, "required": [ "node", "relation_type", "relation_type_formatted" ] }, "Recommendation": { "title": "Recommendation", "description": "Representation of anime or manga recommendation", "type": "object", "properties": { "num_recommendations": { "title": "Num Recommendations", "type": "integer" }, "node": { "$ref": "#/definitions/Node" } }, "required": [ "num_recommendations", "node" ] }, "RankingObject": { "title": "RankingObject", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "rank": { "title": "Rank", "type": "integer" }, "previous_rank": { "title": "Previous Rank", "type": "integer" } }, "required": [ "rank" ] }, "AnimeSeason": { "title": "AnimeSeason", "description": "Representation of anime season (f.e. winter 2022)", "type": "object", "properties": { "year": { "title": "Year", "type": "integer" }, "season": { "title": "Season", "type": "string" } }, "required": [ "year", "season" ] }, "Broadcast": { "title": "Broadcast", "description": "Object representing date of episode broadcast (in JST)", "type": "object", "properties": { "day_of_the_week": { "title": "Day Of The Week", "type": "string" }, "start_time": { "title": "Start Time", "type": "string", "format": "time" } }, "required": [ "day_of_the_week" ] }, "AnimeSource": { "title": "AnimeSource", "description": "Enumerator representing source of anime\n\n* **OTHER** - Other\n* **ORIGINAL** - Original\n* **MANGA** - Manga\n* **MANGA_4_KOMA** - 4-Koma, comedic manga format\n* **WEB_MANGA** - Web Manga\n* **WEB_NOVEL** - Web Novel\n* **DIGITAL_MANGA** - Digital Manga\n* **NOVEL** - Novel\n* **LIGHT_NOVEL** - Light Novel\n* **VISUAL_NOVEL** - Text-based video game\n* **GAME** - Game\n* **CARD_GAME** - Card Game\n* **BOOK** - Book\n* **PICTURE_BOOK** - Picture Book\n* **RADIO** - Radio\n* **MUSIC** - Music\n* **MIXED_MEDIA** - Mixed Media", "enum": [ "other", "original", "manga", "4_koma_manga", "web_manga", "web_novel", "digital_manga", "novel", "light_novel", "visual_novel", "game", "card_game", "book", "picture_book", "radio", "music", "mixed_media" ] }, "Rating": { "title": "Rating", "description": "Rating of shows provided by myanimelist:\n\n* **G** - All Ages\n* **PG** - Children\n* **PG_13** - Teens 13 and Older\n* **R** - 17+ (violence & profanity)\n* **RR** - Profanity & Mild Nudity\n* **Rx** - Hentai", "enum": [ "g", "pg", "pg_13", "r", "r+", "rx" ] }, "Studio": { "title": "Studio", "description": "Representation of anime studio", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }, "Statistics": { "title": "Statistics", "description": "Object representing list statistics of anime on MAL", "type": "object", "properties": { "num_list_users": { "title": "Num List Users", "type": "integer" }, "watching": { "title": "Watching", "type": "integer" }, "completed": { "title": "Completed", "type": "integer" }, "on_hold": { "title": "On Hold", "type": "integer" }, "dropped": { "title": "Dropped", "type": "integer" }, "plan_to_watch": { "title": "Plan To Watch", "type": "integer" } }, "required": [ "num_list_users", "watching", "completed", "on_hold", "dropped", "plan_to_watch" ] }, "Video": { "title": "Video", "description": "Class containing information about video attached to anime, f.e. PV", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "url": { "title": "Url", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "created_at": { "title": "Created At", "type": "string", "format": "date-time" }, "updated_at": { "title": "Updated At", "type": "string", "format": "date-time" }, "thumbnail": { "title": "Thumbnail", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "id", "title", "url", "created_at", "updated_at", "thumbnail" ] }, "Animeography": { "title": "Animeography", "description": "Object represents animeography of character.\nIt might be populated same way as AnimeObject, depending on fields requested.\nHowever it always contains role field, which represents role given to character in anime.\n\nThis object is only available in Character object.", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" }, "alternative_titles": { "title": "Alternative Titles", "type": "object" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "end_date": { "title": "End Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "synopsis": { "title": "Synopsis", "type": "string" }, "mean": { "title": "Mean", "type": "number" }, "rank": { "title": "Rank", "type": "integer" }, "popularity": { "title": "Popularity", "type": "integer" }, "num_list_users": { "title": "Num List Users", "type": "integer" }, "num_scoring_users": { "title": "Num Scoring Users", "type": "integer" }, "nsfw": { "$ref": "#/definitions/Nsfw" }, "genres": { "title": "Genres", "type": "array", "items": { "$ref": "#/definitions/Genre" } }, "created_at": { "title": "Created At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "media_type": { "$ref": "#/definitions/AnimeType" }, "status": { "$ref": "#/definitions/AnimeStatus" }, "my_list_status": { "$ref": "#/definitions/MyAnimeListStatus" }, "pictures": { "title": "Pictures", "type": "array", "items": { "$ref": "#/definitions/Asset" } }, "background": { "title": "Background", "type": "string" }, "related_anime": { "title": "Related Anime", "type": "array", "items": { "$ref": "#/definitions/Relation" } }, "related_manga": { "title": "Related Manga", "type": "array", "items": { "$ref": "#/definitions/Relation" } }, "recommendations": { "title": "Recommendations", "type": "array", "items": { "$ref": "#/definitions/Recommendation" } }, "list_status": { "$ref": "#/definitions/MyAnimeListStatus" }, "ranking": { "$ref": "#/definitions/RankingObject" }, "num_episodes": { "title": "Num Episodes", "type": "integer" }, "start_season": { "$ref": "#/definitions/AnimeSeason" }, "broadcast": { "$ref": "#/definitions/Broadcast" }, "source": { "title": "Source", "anyOf": [ { "$ref": "#/definitions/AnimeSource" }, { "type": "string" } ] }, "average_episode_duration": { "title": "Average Episode Duration", "type": "integer" }, "rating": { "$ref": "#/definitions/Rating" }, "studios": { "title": "Studios", "type": "array", "items": { "$ref": "#/definitions/Studio" } }, "statistics": { "$ref": "#/definitions/Statistics" }, "videos": { "title": "Videos", "type": "array", "items": { "$ref": "#/definitions/Video" } }, "role": { "title": "Role", "type": "string" } }, "required": [ "id", "title" ] } } }- Fields
role (Optional[str])alternative_name (Optional[str])main_picture (Optional[malclient.Datamodels.models.Asset])biography (Optional[str])pictures (Optional[list[malclient.Datamodels.models.Asset]])animeography (Optional[list[malclient.Datamodels.models.Animeography]])num_favorites (Optional[int])
Note
This is available only in alpha build of a wrapper
Manga Specific¶
-
class
malclient.MangaObject¶ -
Model of manga fetched from myanimelist Some fields may not be mentioned in official documentation
Show JSON schema
json{ "title": "MangaObject", "description": "Model of manga fetched from myanimelist\nSome fields may not be mentioned in official documentation", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" }, "alternative_titles": { "title": "Alternative Titles", "type": "object" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "end_date": { "title": "End Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "synopsis": { "title": "Synopsis", "type": "string" }, "mean": { "title": "Mean", "type": "number" }, "rank": { "title": "Rank", "type": "integer" }, "popularity": { "title": "Popularity", "type": "integer" }, "num_list_users": { "title": "Num List Users", "type": "integer" }, "num_scoring_users": { "title": "Num Scoring Users", "type": "integer" }, "nsfw": { "$ref": "#/definitions/Nsfw" }, "genres": { "title": "Genres", "type": "array", "items": { "$ref": "#/definitions/Genre" } }, "created_at": { "title": "Created At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "media_type": { "title": "Media Type", "anyOf": [ { "$ref": "#/definitions/MangaType" }, { "type": "string" } ] }, "status": { "title": "Status", "anyOf": [ { "$ref": "#/definitions/MangaStatus" }, { "type": "string" } ] }, "my_list_status": { "$ref": "#/definitions/MyMangaListStatus" }, "pictures": { "title": "Pictures", "type": "array", "items": { "$ref": "#/definitions/Asset" } }, "background": { "title": "Background", "type": "string" }, "related_anime": { "title": "Related Anime", "type": "array", "items": { "$ref": "#/definitions/Relation" } }, "related_manga": { "title": "Related Manga", "type": "array", "items": { "$ref": "#/definitions/Relation" } }, "recommendations": { "title": "Recommendations", "type": "array", "items": { "$ref": "#/definitions/Recommendation" } }, "list_status": { "$ref": "#/definitions/MyMangaListStatus" }, "ranking": { "$ref": "#/definitions/RankingObject" }, "num_volumes": { "title": "Num Volumes", "type": "integer" }, "num_chapters": { "title": "Num Chapters", "type": "integer" }, "authors": { "title": "Authors", "type": "array", "items": { "$ref": "#/definitions/MangaAuthor" } }, "serialization": { "title": "Serialization", "type": "array", "items": { "$ref": "#/definitions/Serialization" } } }, "required": [ "id", "title" ], "definitions": { "Asset": { "title": "Asset", "description": "Asset object, commonly representing an image with two resolutions", "type": "object", "properties": { "large": { "title": "Large", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" }, "medium": { "title": "Medium", "minLength": 1, "maxLength": 2083, "format": "uri", "type": "string" } }, "required": [ "medium" ] }, "Nsfw": { "title": "Nsfw", "description": "Enumerator representing nsfw stages:\n\n* **WHITE** - White\n* **GRAY** - Gray\n* **BLACK** - Black", "enum": [ "white", "gray", "black" ] }, "Genre": { "title": "Genre", "description": "Anime or Manga Genre", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }, "MangaType": { "title": "MangaType", "description": "Enumerator representing type of manga\n\n* **UNKNOWN** - Unknown\n* **MANGA** - Manga\n* **NOVEL** - Novel\n* **ONE_SHOT** = One-Shot\n* **DOUJIN** - Self-published Manga\n* **MANHWA** - Korean comic\n* **MANHUA** - Chinese comic\n* **LIGHT_NOVEL** - Light Novel\n* **OEL** - Original English-Language Manga", "enum": [ "unknown", "manga", "novel", "one_shot", "doujinshi", "manhwa", "manhua", "oel", "light_novel" ] }, "MangaStatus": { "title": "MangaStatus", "description": "Enumerating representing current manga status\n\n* **FINISHED** - Finished\n* **PUBLISHING** - Currently Publishing\n* **NOT_PUBLISHED** - Not Yet Published\n* **ON_HIATUS** - On Break\n* **DISCONTINUED** - Discontinued", "enum": [ "finished", "currently_publishing", "not_yet_published", "on_hiatus", "discontinued" ] }, "MyMangaListStatus": { "title": "MyMangaListStatus", "description": "Status from users manga list", "type": "object", "properties": { "score": { "title": "Score", "type": "integer" }, "status": { "title": "Status", "type": "string" }, "is_rereading": { "title": "Is Rereading", "type": "boolean" }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "num_chapters_read": { "title": "Num Chapters Read", "type": "integer" }, "num_volumes_read": { "title": "Num Volumes Read", "type": "integer" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "finish_date": { "title": "Finish Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "priority": { "title": "Priority", "type": "integer" }, "num_times_reread": { "title": "Num Times Reread", "type": "integer" }, "reread_value": { "title": "Reread Value", "type": "integer" }, "tags": { "title": "Tags", "type": "array", "items": { "type": "string" } }, "comments": { "title": "Comments", "type": "string" } } }, "Node": { "title": "Node", "description": "Object representing simplified anime/manga info", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "main_picture": { "$ref": "#/definitions/Asset" } }, "required": [ "id", "title" ] }, "Relation": { "title": "Relation", "description": "Object representing relations between anime and/or manga", "type": "object", "properties": { "node": { "$ref": "#/definitions/Node" }, "relation_type": { "title": "Relation Type", "type": "string" }, "relation_type_formatted": { "title": "Relation Type Formatted", "type": "string" } }, "required": [ "node", "relation_type", "relation_type_formatted" ] }, "Recommendation": { "title": "Recommendation", "description": "Representation of anime or manga recommendation", "type": "object", "properties": { "num_recommendations": { "title": "Num Recommendations", "type": "integer" }, "node": { "$ref": "#/definitions/Node" } }, "required": [ "num_recommendations", "node" ] }, "RankingObject": { "title": "RankingObject", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "rank": { "title": "Rank", "type": "integer" }, "previous_rank": { "title": "Previous Rank", "type": "integer" } }, "required": [ "rank" ] }, "PersonBase": { "title": "PersonBase", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "first_name": { "title": "First Name", "type": "string" }, "last_name": { "title": "Last Name", "type": "string" } }, "required": [ "id", "first_name", "last_name" ] }, "MangaAuthor": { "title": "MangaAuthor", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "node": { "$ref": "#/definitions/PersonBase" }, "role": { "title": "Role", "type": "string" } }, "required": [ "node", "role" ] }, "Magazine": { "title": "Magazine", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ] }, "Serialization": { "title": "Serialization", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "node": { "$ref": "#/definitions/Magazine" }, "role": { "title": "Role", "type": "string" } }, "required": [ "node" ] } } }- Fields
media_type (Optional[Union[malclient.Datamodels.enums.MangaType, str]])status (Optional[Union[malclient.Datamodels.enums.MangaStatus, str]])my_list_status (Optional[malclient.Datamodels.models.MyMangaListStatus])num_volumes (Optional[int])num_chapters (Optional[int])authors (Optional[list[malclient.Datamodels.models.MangaAuthor]])serialization (Optional[list[malclient.Datamodels.models.Serialization]])list_status (Optional[malclient.Datamodels.models.MyMangaListStatus])
-
populate(client)¶ -
Send new request and return new object containing full details
- Parameters
client (malclient.Client) – client with which new data will be fetched
- Returns
Fully populated MangaObject
- Return type
-
class
malclient.MangaType(value)¶ -
Enumerator representing type of manga
UNKNOWN - Unknown
MANGA - Manga
NOVEL - Novel
ONE_SHOT = One-Shot
DOUJIN - Self-published Manga
MANHWA - Korean comic
MANHUA - Chinese comic
LIGHT_NOVEL - Light Novel
OEL - Original English-Language Manga
-
class
malclient.MyMangaListStatus¶ -
Status from users manga list
Show JSON schema
json{ "title": "MyMangaListStatus", "description": "Status from users manga list", "type": "object", "properties": { "score": { "title": "Score", "type": "integer" }, "status": { "title": "Status", "type": "string" }, "is_rereading": { "title": "Is Rereading", "type": "boolean" }, "updated_at": { "title": "Updated At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "num_chapters_read": { "title": "Num Chapters Read", "type": "integer" }, "num_volumes_read": { "title": "Num Volumes Read", "type": "integer" }, "start_date": { "title": "Start Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "finish_date": { "title": "Finish Date", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "priority": { "title": "Priority", "type": "integer" }, "num_times_reread": { "title": "Num Times Reread", "type": "integer" }, "reread_value": { "title": "Reread Value", "type": "integer" }, "tags": { "title": "Tags", "type": "array", "items": { "type": "string" } }, "comments": { "title": "Comments", "type": "string" } } }- Fields
score (Optional[int])status (Optional[str])is_rereading (Optional[bool])updated_at (Optional[Union[datetime.datetime, str]])num_chapters_read (Optional[int])num_volumes_read (Optional[int])start_date (Optional[Union[datetime.date, str]])finish_date (Optional[Union[datetime.date, str]])priority (Optional[int])num_times_reread (Optional[int])reread_value (Optional[int])tags (Optional[list[str]])comments (Optional[str])
-
class
malclient.MangaStatus(value)¶ -
Enumerating representing current manga status
FINISHED - Finished
PUBLISHING - Currently Publishing
NOT_PUBLISHED - Not Yet Published
ON_HIATUS - On Break
DISCONTINUED - Discontinued
-
class
malclient.MangaRankingType(value)¶ -
Representation of possible values for manga ranking type
ALL - All
MANGA - Top Manga
NOVELS - Top Novels
ONE_SHOTS - Top One Shot Manga
DOUJIN - Top Doujinshi
MANHWA - Top Manhwa
MANHUA - Top Manhua
POPULAR - Most popular
FAVORITE - Most Favorited
-
class
malclient.MyMangaListSorting(value)¶ -
Sorting options for User Manga List
LIST_SCORE - Sorted by score given by user
LAST_UPDATE - Sorted by most recently updated
TITLE - Sorted by title
START_DATE - Sorted by series start date
ID - Sorted by manga ID
User¶
-
class
malclient.User¶ -
Show JSON schema
json{ "title": "User", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "picture": { "title": "Picture", "type": "string" }, "gender": { "title": "Gender", "type": "string" }, "birthday": { "title": "Birthday", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "location": { "title": "Location", "type": "string" }, "joined_at": { "title": "Joined At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "time_zone": { "title": "Time Zone", "type": "string" }, "is_supporter": { "title": "Is Supporter", "type": "boolean" }, "anime_statistics": { "$ref": "#/definitions/UserAnimeStatistics" } }, "required": [ "id", "name", "picture" ], "definitions": { "UserAnimeStatistics": { "title": "UserAnimeStatistics", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "num_items_watching": { "title": "Num Items Watching", "type": "integer" }, "num_items_completed": { "title": "Num Items Completed", "type": "integer" }, "num_items_on_hold": { "title": "Num Items On Hold", "type": "integer" }, "num_items_dropped": { "title": "Num Items Dropped", "type": "integer" }, "num_items_plan_to_watch": { "title": "Num Items Plan To Watch", "type": "integer" }, "num_items": { "title": "Num Items", "type": "integer" }, "num_days_watched": { "title": "Num Days Watched", "type": "number" }, "num_days_watching": { "title": "Num Days Watching", "type": "number" }, "num_days_completed": { "title": "Num Days Completed", "type": "number" }, "num_days_on_hold": { "title": "Num Days On Hold", "type": "number" }, "num_days_dropped": { "title": "Num Days Dropped", "type": "number" }, "num_days": { "title": "Num Days", "type": "number" }, "num_episodes": { "title": "Num Episodes", "type": "integer" }, "num_times_rewatched": { "title": "Num Times Rewatched", "type": "integer" }, "mean_score": { "title": "Mean Score", "type": "number" } }, "required": [ "num_items_watching", "num_items_completed", "num_items_on_hold", "num_items_dropped", "num_items_plan_to_watch", "num_items", "num_days_watched", "num_days_watching", "num_days_completed", "num_days_on_hold", "num_days_dropped", "num_days", "num_episodes", "num_times_rewatched", "mean_score" ] } } }- Fields
id (int)name (str)picture (str)gender (Optional[str])birthday (Optional[Union[datetime.date, str]])location (Optional[str])joined_at (Optional[Union[datetime.datetime, str]])time_zone (Optional[str])is_supporter (Optional[bool])anime_statistics (Optional[malclient.Datamodels.models.UserAnimeStatistics])
-
class
malclient.UserAnimeStatistics¶ -
Show JSON schema
json{ "title": "UserAnimeStatistics", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "num_items_watching": { "title": "Num Items Watching", "type": "integer" }, "num_items_completed": { "title": "Num Items Completed", "type": "integer" }, "num_items_on_hold": { "title": "Num Items On Hold", "type": "integer" }, "num_items_dropped": { "title": "Num Items Dropped", "type": "integer" }, "num_items_plan_to_watch": { "title": "Num Items Plan To Watch", "type": "integer" }, "num_items": { "title": "Num Items", "type": "integer" }, "num_days_watched": { "title": "Num Days Watched", "type": "number" }, "num_days_watching": { "title": "Num Days Watching", "type": "number" }, "num_days_completed": { "title": "Num Days Completed", "type": "number" }, "num_days_on_hold": { "title": "Num Days On Hold", "type": "number" }, "num_days_dropped": { "title": "Num Days Dropped", "type": "number" }, "num_days": { "title": "Num Days", "type": "number" }, "num_episodes": { "title": "Num Episodes", "type": "integer" }, "num_times_rewatched": { "title": "Num Times Rewatched", "type": "integer" }, "mean_score": { "title": "Mean Score", "type": "number" } }, "required": [ "num_items_watching", "num_items_completed", "num_items_on_hold", "num_items_dropped", "num_items_plan_to_watch", "num_items", "num_days_watched", "num_days_watching", "num_days_completed", "num_days_on_hold", "num_days_dropped", "num_days", "num_episodes", "num_times_rewatched", "mean_score" ] }- Fields
num_items_watching (int)num_items_completed (int)num_items_on_hold (int)num_items_dropped (int)num_items_plan_to_watch (int)num_items (int)num_days_watched (float)num_days_watching (float)num_days_completed (float)num_days_on_hold (float)num_days_dropped (float)num_days (float)num_episodes (int)num_times_rewatched (int)mean_score (float)
Fields¶
-
class
malclient.Fields(**kwargs)¶ -
Object containing all fields possible for anime and manga num_favorites, opening_themes, ending_themes are not documented by MAL
Available Fields¶ Value
Description
id
Unique ID from MyAnimeList
title
Name of the show
main_picture
Picture picked to represent series
alternative_titles
Synonyms and translations of title
start_date
start date
end_date
finish date
synopsis
Short description of series
background
Additional information about showYou cannot contain this field in a listmean
Average of all scoresSometimes, f.e. when number of users is low, mean won’t be calculatedrank
Position in ranking on websiteSometimes, f.e. when number of users is low, rank won’t be calculatedpopularity
Position in popularity ranking on website
num_list_users
Number of users who have this title in their lists
num_scoring_users
Number of users who have give score to this title
updated_at
Date and time of last update
genres
List of all genres assigned to this title
my_list_status
Entry from validated user list for this title
pictures
List containing all assetsYou cannot contain this field in a list.related_anime
List of all related animeCurrently not working for manga entriesYou cannot contain this field in a list.related_manga
List of all related mangaCurrently not working for anime entriesYou cannot contain this field in a list.recommendations
Summary of recommended titles for people who liked this oYou cannot contain this field in a list.nsfw
NSFW rating value
created_at
Creation date for this entry
media_type
Media type
status
Current airing status
num_favorites
Number of users who have this title in their favourites
num_episodes
Total number of episodesAvailable only for anime entriesstart_season
Season in which anime started airingAvailable only for anime entriesbroadcast
Day of broadcastAvailable only for anime entriessource
Media type for anime sourceAvailable only for anime entriesaverage_episode_duration
Avarage length of one episodeAvailable only for anime entriesrating
TV age ratingAvailable only for anime entriesstudios
list of studios creating this animeAvailable only for anime entriesopening_themes
List of opening songsAvailable only for anime entriesending_themes
List of ending songsAvailable only for anime entriesstatistics
Number of users for each list statusAvailable only for anime entriesYou cannot contain this field in a list.num_volumes
Total number of volumes for this mangaAvailable only for manga entriesnum_chapters
Total number of chapters for this mangaAvailable only for manga entriesauthors
List of people who created this mangaAvailable only for manga entriesserialization
Information on manga serializationAvailable only for manga entriesYou cannot contain this field in a list.-
classmethod
anime()¶ -
Generates Fields object containing all parameters taken by anime
-
classmethod
empty()¶ -
Generates empty fields object Might be overridden by some classes, which have parameters set to True by default
-
classmethod
manga()¶ -
Generates Fields object containing all parameters taken by manga
-
classmethod
node()¶ -
Generates Fields object containing only parameters taken by node
-
classmethod
-
class
malclient.AuthorFields(**kwargs)¶ -
Helper fields class containing info about manga author
Available Fields¶ Value
Description
first_name
Author’s first name
last_name
Author’s last name
-
classmethod
empty()¶ -
Generates empty fields object Might be overridden by some classes, which have parameters set to True by default
-
classmethod
-
class
malclient.ListStatusFields(**kwargs)¶ -
Helper fields class containing precise data for my_list_status
Available Fields¶ Field name
Description
Score
Number of points given
status
Status on list
updated_at
Date and time of last update
start_date
Start date
finish_date
Finish Date
priority
Importance, set by user
tags
Tags given to this entry by user
comments
Additional comment provided by user
num_episodes_watched
Number of episodes watched by userAvailable only for anime entriesis_rewatching
Describes if user is rewatching this seriesAvailable only for anime entriesnum_times_rewatched
Number of times user already rewatched this seriesAvailable only for anime entriesrewatch_value
How likely is user to rewatch this seriesAvailable only for anime entriesis_rereading
Describes if user is rewatching this seriesAvailable only for manga entriesnum_volumes_read
Number of volumes read by userAvailable only for anime entriesnum_chapters_read
Number of chapters read by userAvailable only for anime entriesnum_times_reread
Number of times user already reread this seriesAvailable only for manga entriesreread_value
How likely is user to reread this seriesAvailable only for manga entries-
classmethod
anime_full()¶ -
All fields for anime list status
-
classmethod
empty()¶ -
Generates empty fields object Might be overridden by some classes, which have parameters set to True by default
-
classmethod
manga_full()¶ -
All fields for manga list status
-
classmethod
Note
This is available only in alpha build of a wrapper
-
class
malclient.CharacterFields(**kwargs)¶ -
Available Fields¶ Value
Description
id
Character’s id on MAL
role
Character’s role in anime one of: [Main, Supporting]
first_name
Character’s first name
last_name
Character’s last name
alternative_name
List of alternative names
main_picture
Main picture for character
biography
Character’s description on MAL
pictures
List of all pictures for this characterYou cannot contain this field in a list.animeography
List of all anime in which this character appearsYou cannot contain this field in a list.num_favorite
Number of users who have this character in their favourites
Forums¶
-
class
malclient.ForumTopic¶ -
Show JSON schema
json{ "title": "ForumTopic", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "created_at": { "title": "Created At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "created_by": { "$ref": "#/definitions/ForumAuthor" }, "number_of_posts": { "title": "Number Of Posts", "type": "integer" }, "last_post_created_at": { "title": "Last Post Created At", "anyOf": [ { "type": "string", "format": "date" }, { "type": "string" } ] }, "is_locked": { "title": "Is Locked", "type": "boolean" } }, "required": [ "id", "title", "created_at", "created_by", "number_of_posts", "last_post_created_at", "is_locked" ], "definitions": { "ForumAuthor": { "title": "ForumAuthor", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "forum_avator": { "title": "Forum Avator", "type": "string" } }, "required": [ "id", "name" ] } } }- Fields
id (int)title (str)created_at (Union[datetime.datetime, str])created_by (malclient.Datamodels.models.ForumAuthor)number_of_posts (int)last_post_created_at (Union[datetime.date, str])is_locked (bool)
-
class
malclient.ForumCategory¶ -
Show JSON schema
json{ "title": "ForumCategory", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "title": { "title": "Title", "type": "string" }, "boards": { "title": "Boards", "type": "array", "items": { "$ref": "#/definitions/ForumBoard" } } }, "required": [ "title", "boards" ], "definitions": { "ForumSubboard": { "title": "ForumSubboard", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ] }, "ForumBoard": { "title": "ForumBoard", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "description": { "title": "Description", "type": "string" }, "subboards": { "title": "Subboards", "type": "array", "items": { "$ref": "#/definitions/ForumSubboard" } } }, "required": [ "id", "title", "description", "subboards" ] } } }- Fields
title (str)boards (list[malclient.Datamodels.models.ForumBoard])
-
class
malclient.ForumTopicDetail(title=None, posts=None, polls=None, paging_data={})¶ -
Object represents details about forum topic on MAL, has paging support for list of posts
-
class
malclient.ForumBoard¶ -
Show JSON schema
json{ "title": "ForumBoard", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" }, "description": { "title": "Description", "type": "string" }, "subboards": { "title": "Subboards", "type": "array", "items": { "$ref": "#/definitions/ForumSubboard" } } }, "required": [ "id", "title", "description", "subboards" ], "definitions": { "ForumSubboard": { "title": "ForumSubboard", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ] } } }- Fields
id (int)title (str)description (str)subboards (list[malclient.Datamodels.models.ForumSubboard])
-
class
malclient.ForumSubboard¶ -
Show JSON schema
json{ "title": "ForumSubboard", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ] }- Fields
id (int)title (str)
-
class
malclient.ForumAuthor¶ -
Show JSON schema
json{ "title": "ForumAuthor", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "forum_avator": { "title": "Forum Avator", "type": "string" } }, "required": [ "id", "name" ] }- Fields
id (int)name (str)forum_avator (Optional[str])
-
class
malclient.ForumPost¶ -
Show JSON schema
json{ "title": "ForumPost", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "number": { "title": "Number", "type": "integer" }, "created_at": { "title": "Created At", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "created_by": { "$ref": "#/definitions/ForumAuthor" }, "body": { "title": "Body", "type": "string" }, "signature": { "title": "Signature", "type": "string" } }, "required": [ "id", "number", "created_at", "created_by", "body", "signature" ], "definitions": { "ForumAuthor": { "title": "ForumAuthor", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "forum_avator": { "title": "Forum Avator", "type": "string" } }, "required": [ "id", "name" ] } } }- Fields
id (int)number (int)created_at (Union[datetime.datetime, str])created_by (malclient.Datamodels.models.ForumAuthor)body (str)signature (str)
-
class
malclient.ForumPoll¶ -
Show JSON schema
json{ "title": "ForumPoll", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "question": { "title": "Question", "type": "string" }, "close": { "title": "Close", "type": "boolean" }, "options": { "title": "Options", "type": "array", "items": { "$ref": "#/definitions/ForumPollOption" } } }, "required": [ "id", "question", "close", "options" ], "definitions": { "ForumPollOption": { "title": "ForumPollOption", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "text": { "title": "Text", "type": "string" }, "votes": { "title": "Votes", "type": "integer" } }, "required": [ "id", "text", "votes" ] } } }- Fields
id (int)question (str)close (bool)options (list[malclient.Datamodels.models.ForumPollOption])
-
class
malclient.ForumPollOption¶ -
Show JSON schema
json{ "title": "ForumPollOption", "description": "Helper model class used to generate all models used by this API", "type": "object", "properties": { "id": { "title": "Id", "type": "integer" }, "text": { "title": "Text", "type": "string" }, "votes": { "title": "Votes", "type": "integer" } }, "required": [ "id", "text", "votes" ] }- Fields
id (int)text (str)votes (int)