Attack on Titan API

Intro Characters Episodes Locations Organizations Titans

Characters

There are 201 characters with 11 pages.

Character schema

Key	Type	Description
id	int	The character's id.
name	string	The character's name.
img	string	The url to the character's image.
alias	string[]	The character's aliases.
species	string[]	The character's species.
gender	string	The character's gender.
age	int	The character's age.
height	string	The character's height.
relatives	object[]	The families and people the character is related to.
birthplace	string	The character's birthplace.
residence	string	The character's residence.
status	stirng	The character's status (alive or dead)
occupation	string	The character's occupation
groups	object[]	The groups the character belongs to.
roles	string[]	The character's roles.
episodes	string[]	The episodes the character appears in.

Get all characters

You can access all the characters by using the /characters endpoint.

GET https://api.attackontitanapi.com/characters

{
    "info": {
      "count": 201,
      "pages": 11,
      "next_page": "https://api.attackontitanapi.com/characters?page=2",
      "prev_page": null
    },
    "results": [
      {
        "id": 1,
        "name": "Armin Arlelt",
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/9/93/Armin_Arlelt_%28Anime%29_character_image.png/revision/latest/scale-to-width-down/350?cb=20210322005647",
        "alias": [
          "Colossal Titan"
        ],
        "species": [
          "Human",
          "Intelligent Titan"
        ],
        "gender": "Male",
        "age": 19,
        "height": "60 m (Colossal Titan form)",
        "relatives": [
          {
            "family": "Arlelt family",
            "members": [
              "Unnamed father",
              "Unnamed mother",
              "Unnamed grandfather"
            ]
          }
        ],
        "birthplace": "Shiganshina District",
        "residence": "Wall Rose",
        "status": "Alive",
        "occupation": "Soldier",
        "groups": [
          {
            "name": "Scout Regiment",
            "sub_groups": [
              "Special Operations Squad"
            ]
          }
        ],
        "roles": [
          "Colossal Titans",
          "Scout Regiment Commanders"
        ],
        "episodes": [
          "https://api.attackontitanapi.com/episodes/1",
          "https://api.attackontitanapi.com/episodes/2",
          "https://api.attackontitanapi.com/episodes/3",
          "https://api.attackontitanapi.com/episodes/4",
          // ...
        ]
      },
      // ...
    ]

Get a single character

You can get a single character by adding an id as the request parameter /characters/188.

GET https://api.attackontitanapi.com/characters/188

{
    "id": 188,
    "name": "Eren Jaeger",
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/a1/Eren_Jaeger_%28Anime%29_character_image.png/revision/latest/scale-to-width-down/350?cb=20220123225500",
    "alias": [
      "Suicidal Maniac",
      "Titan boy",
      "Attack Titan",
      "Mysterious Titan",
      "Berserk Titan",
      "Founding Titan",
      "Founder",
      "Mister Kruger",
      "Usurper",
      "War Hammer Titan",
      "Doomsday Titan"
    ],
    "species": [
      "Human",
      "Intelligent Titan"
    ],
    "gender": "Male",
    "age": 19,
    "height": "15 m (Titan form)",
    "relatives": [
      {
        "family": "Jaeger family",
        "members": [
          "https://api.attackontitanapi.com/characters/160",
          "https://api.attackontitanapi.com/characters/161",
          "https://api.attackontitanapi.com/characters/184",
          "https://api.attackontitanapi.com/characters/173",
          "Unnamed grandmother",
          "https://api.attackontitanapi.com/characters/181"
        ]
      }
    ],
    "birthplace": "Shiganshina District",
    "residence": "Wall Rose",
    "status": "Alive",
    "occupation": "Soldier",
    "groups": [],
    "roles": [
      "Attack Titans",
      "Founding Titans",
      "War Hammer Titans"
    ],
    "episodes": [
      "https://api.attackontitanapi.com/episodes/1",
      "https://api.attackontitanapi.com/episodes/2",
      "https://api.attackontitanapi.com/episodes/3",
      // ...
    ]
}

Get multiple characters

You can get multiple characters by adding an list of ids as the request parameter /characters/188,1.

GET https://api.attackontitanapi.com/characters/188,1

[
    {
      "id": 59,
      "name": "Duran",
      "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/b/b2/Duran_%28Anime%29_character_image.png/revision/latest/scale-to-width-down/350?cb=20180730213708",
      "alias": [],
      "species": [
        "Human"
      ],
      "gender": "Male",
      "age": null,
      "height": null,
      "relatives": [],
      "birthplace": null,
      "residence": "Wall Sina",
      "status": "Deceased",
      "occupation": "Soldier",
      "groups": [
        {
          "name": "Military Police Regiment",
          "sub_groups": [
            "Anti-Personnel Control Squad"
          ]
        }
      ],
      "roles": [],
      "episodes": [
        "https://api.attackontitanapi.com/episodes/38",
        "https://api.attackontitanapi.com/episodes/39",
        "https://api.attackontitanapi.com/episodes/43"
      ]
    },
    {
      "id": 188,
      "name": "Eren Jaeger",
      "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/a1/Eren_Jaeger_%28Anime%29_character_image.png/revision/latest/scale-to-width-down/350?cb=20220123225500",
      "alias": [
        "Suicidal Maniac",
        "Titan boy",
        "Attack Titan",
        "Mysterious Titan",
        "Berserk Titan",
        "Founding Titan",
        "Founder",
        "Mister Kruger",
        "Usurper",
        "War Hammer Titan",
        "Doomsday Titan"
      ],
      "species": [
        "Human",
        "Intelligent Titan"
      ],
      "gender": "Male",
      "age": 19,
      "height": "15 m (Titan form)",
      "relatives": [
        {
          "family": "Jaeger family",
          "members": [
            "https://api.attackontitanapi.com/characters/160",
            "https://api.attackontitanapi.com/characters/161",
            "https://api.attackontitanapi.com/characters/184",
            "https://api.attackontitanapi.com/characters/173",
            "Unnamed grandmother",
            "https://api.attackontitanapi.com/characters/181"
          ]
        }
      ],
      "birthplace": "Shiganshina District",
      "residence": "Wall Rose",
      "status": "Alive",
      "occupation": "Soldier",
      "groups": [],
      "roles": [
        "Attack Titans",
        "Founding Titans",
        "War Hammer Titans"
      ],
      "episodes": [
        "https://api.attackontitanapi.com/episodes/1",
        "https://api.attackontitanapi.com/episodes/2",
        "https://api.attackontitanapi.com/episodes/3",
        // ...
      ]
    }
]

Filter characters

To filter characters to include a query in the request. Add a ? followed by the query <query>=value>. To chain multiple queries seperate them by &.

Available parameters:

name: Filter by name
gender: Filter by gender (male, female, or unknown)
status: Filter by status (alive, deceased, or unknown)
occupation: Filter by occupation (soldier, thug, etc.)

GET https://api.attackontitanapi.com/characters?status=alive&occupation=soldier

{
    "info": {
      "count": 26,
      "pages": 2,
      "next_page": "https://api.attackontitanapi.com/characters?page=2?status=alive&occupation=soldier",
      "prev_page": null
    },
    "results": [
      {
        "id": 1,
        "name": "Armin Arlelt",
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/9/93/Armin_Arlelt_%28Anime%29_character_image.png/revision/latest/scale-to-width-down/350?cb=20210322005647",
        "alias": [
          "Colossal Titan"
        ],
        "species": [
          "Human",
          "Intelligent Titan"
        ],
        "gender": "Male",
        "age": 19,
        "height": "60 m (Colossal Titan form)",
        "relatives": [
          {
            "family": "Arlelt family",
            "members": [
              "Unnamed father",
              "Unnamed mother",
              "Unnamed grandfather"
            ]
          }
        ],
        "birthplace": "Shiganshina District",
        "residence": "Wall Rose",
        "status": "Alive",
        "occupation": "Soldier",
        "groups": [
          {
            "name": "Scout Regiment",
            "sub_groups": [
              "Special Operations Squad"
            ]
          }
        ],
        "roles": [
          "Colossal Titans",
          "Scout Regiment Commanders"
        ],
        "episodes": [
          "https://api.attackontitanapi.com/episodes/1",
          "https://api.attackontitanapi.com/episodes/2",
          "https://api.attackontitanapi.com/episodes/3",
          // ...
        ]
      },
      {
        "id": 2,
        "name": "Mikasa Ackermann",
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/4/4f/Mikasa_Ackermann_%28Anime%29_character_image.png/revision/latest/scale-to-width-down/350?cb=20210221220718",
        "alias": [],
        "species": [
          "Human"
        ],
        "gender": "Female",
        "age": 19,
        "height": null,
        "relatives": [
          {
            "family": "Ackermann family",
            "members": [
              "Unnamed father",
              "Unnamed relative",
              "https://api.attackontitanapi.com/characters/57",
              "https://api.attackontitanapi.com/characters/165",
              "https://api.attackontitanapi.com/characters/5",
              "Unnamed mother",
              "https://api.attackontitanapi.com/characters/125"
            ]
          }
        ],
        "birthplace": "Shiganshina District Outskirts? → Shiganshina District",
        "residence": "Wall Rose",
        "status": "Alive",
        "occupation": "Soldier",
        "groups": [
          {
            "name": "Scout Regiment",
            "sub_groups": [
              "Special Operations Squad"
            ]
          }
        ],
        "roles": [],
        "episodes": [
          "https://api.attackontitanapi.com/episodes/1",
          "https://api.attackontitanapi.com/episodes/2",
          "https://api.attackontitanapi.com/episodes/3",
          // ...
        ]
      },
      {
        "id": 3,
        "name": "Jean Kirschtein",
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/3/38/Jean_Kirschtein_%28Anime%29_character_image.png/revision/latest/scale-to-width-down/350?cb=20210207230042",
        "alias": [
          "Horse face"
        ],
        "species": [
          "Human"
        ],
        "gender": "Male",
        "age": 19,
        "height": null,
        "relatives": [
          {
            "family": "Kirschtein family",
            "members": [
              "Unnamed mother",
              "Unnamed father[2]"
            ]
          }
        ],
        "birthplace": "Trost District",
        "residence": "Wall Rose",
        "status": "Alive",
        "occupation": "Soldier",
        "groups": [
          {
            "name": "Scout Regiment",
            "sub_groups": [
              "Special Operations Squad"
            ]
          }
        ],
        "roles": [],
        "episodes": [
          "https://api.attackontitanapi.com/episodes/2",
          "https://api.attackontitanapi.com/episodes/3",
          "https://api.attackontitanapi.com/episodes/4",
          // ...
        ]
    },
    // ...
]