AniList · JSON Structure

Anilist Character Structure

A character that features in an anime or manga

Type: object Properties: 15 Required: 3
AnimeMangaEntertainmentMediaSocialDatabaseGraphQLOAuth2Public APIs

Character is a JSON Structure definition published by AniList, describing 15 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id name image description gender dateOfBirth age bloodType isFavourite isFavouriteBlocked siteUrl media updatedAt favourites modNotes

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

anilist-character-structure.json Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/anilist/refs/heads/main/json-structure/anilist-character-structure.json",
  "name": "Character",
  "description": "A character that features in an anime or manga",
  "type": "object",
  "properties": {
    "id": {
      "type": "int32",
      "description": "The id of the character"
    },
    "name": {
      "description": "The names of the character",
      "$ref": "./anilist-charactername-structure.json"
    },
    "image": {
      "description": "Character images",
      "$ref": "./anilist-characterimage-structure.json"
    },
    "description": {
      "type": "string",
      "description": "A general description of the character"
    },
    "gender": {
      "type": "string",
      "description": "The character's gender. Usually Male, Female, or Non-binary but can be any string."
    },
    "dateOfBirth": {
      "description": "The character's birth date",
      "$ref": "./anilist-fuzzydate-structure.json"
    },
    "age": {
      "type": "string",
      "description": "The character's age. Note this is a string, not an int, it may contain further text and additional ages."
    },
    "bloodType": {
      "type": "string",
      "description": "The characters blood type"
    },
    "isFavourite": {
      "type": "boolean",
      "description": "If the character is marked as favourite by the currently authenticated user"
    },
    "isFavouriteBlocked": {
      "type": "boolean",
      "description": "If the character is blocked from being added to favourites"
    },
    "siteUrl": {
      "type": "string",
      "description": "The url for the character page on the AniList website"
    },
    "media": {
      "description": "Media that includes the character",
      "$ref": "./anilist-mediaconnection-structure.json"
    },
    "updatedAt": {
      "type": "int32",
      "deprecated": true
    },
    "favourites": {
      "type": "int32",
      "description": "The amount of user's who have favourited the character"
    },
    "modNotes": {
      "type": "string",
      "description": "Notes for site moderators"
    }
  },
  "required": [
    "id",
    "isFavourite",
    "isFavouriteBlocked"
  ]
}