Attack on Titan API

Intro Characters Episodes Locations Organizations Titans

Titans

There are 9 titans with 1 pages.

Titan schema

Key	Type	Description
id	int	The titan's id.
name	string	The titan's name
img	string	A url to the titan's image.
height	string	The titan's height.
abilities	string[]	The titan's abilities.
current_inheritor	string	The current inheritor of the titan.
former_inheritors	string[]	A list of former inheritors of the titan.
allegiance	string	The titan's allegiance (Marley, Eldia, or None).

Get all titans

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

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

{
  "info": {
    "count": 9,
    "pages": 1,
    "next_page": null,
    "prev_page": null
  },
  "results": [
    {
      "id": 1,
      "name": "Attack Titan",
      "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/ae/Attack_Titan_%28Anime%29_character_image_%28Eren_Jaeger%29.png/revision/latest/scale-to-width-down/350?cb=20170513212951",
      "height": "15m",
      "abilities": [
        "Future memory inheritance"
      ],
      "current_inheritor": "https://api.attackontitanapi.com/characters/188",
      "former_inheritors": [
        "https://api.attackontitanapi.com/characters/160",
        "https://api.attackontitanapi.com/characters/98"
      ],
      "allegiance": "Eldia"
    },
    {
      "id": 2,
      "name": "Founding Titan",
      "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/3/3a/Eren_Jaeger_%28Anime%29_character_image_%28Founding_Titan%29.png/revision/latest/scale-to-width-down/350?cb=20220404091959",
      "height": "350m",
      "abilities": [
        "Titan creation",
        "Titan behavioral control",
        "Memory and body manipulation of subjects of ymir",
        "Telepathic communication with subjects of ymir"
      ],
      "current_inheritor": "https://api.attackontitanapi.com/characters/188",
      "former_inheritors": [
        "https://api.attackontitanapi.com/characters/160",
        "https://api.attackontitanapi.com/characters/110",
        "https://api.attackontitanapi.com/characters/111",
        "https://api.attackontitanapi.com/characters/112",
        "https://api.attackontitanapi.com/characters/113",
        "https://api.attackontitanapi.com/characters/124"
      ],
      "allegiance": [
        "Eldia"
      ]
    },
    // ...
  ]
}

Get a single titan

You can get a single titan by adding an id as the request parameter /titans/1.

GET https://api.attackontitanapi.com/titans/1

{
  "id": 1,
  "name": "Attack Titan",
  "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/ae/Attack_Titan_%28Anime%29_character_image_%28Eren_Jaeger%29.png/revision/latest/scale-to-width-down/350?cb=20170513212951",
  "height": "15m",
  "abilities": [
    "Future memory inheritance"
  ],
  "current_inheritor": "https://api.attackontitanapi.com/characters/188",
  "former_inheritors": [
    "https://api.attackontitanapi.com/characters/160",
    "https://api.attackontitanapi.com/characters/98"
  ],
  "allegiance": "Eldia"
}

Get multiple titans

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

GET https://api.attackontitanapi.com/titans/1,3

[
  {
    "id": 1,
    "name": "Attack Titan",
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/ae/Attack_Titan_%28Anime%29_character_image_%28Eren_Jaeger%29.png/revision/latest/scale-to-width-down/350?cb=20170513212951",
    "height": "15m",
    "abilities": [
      "Future memory inheritance"
    ],
    "current_inheritor": "https://api.attackontitanapi.com/characters/188",
    "former_inheritors": [
      "https://api.attackontitanapi.com/characters/160",
      "https://api.attackontitanapi.com/characters/98"
    ],
    "allegiance": "Eldia"
  },
  {
    "id": 3,
    "name": "War Hammer Titan",
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/b/b2/Lara_Tybur_%28Anime%29_character_image_%28Titan%29.png/revision/latest/scale-to-width-down/350?cb=20210117211130",
    "height": "~15m",
    "abilities": [
      "Structural hardening",
      "Remote operation"
    ],
    "current_inheritor": "https://api.attackontitanapi.com/characters/188",
    "former_inheritors": [
      "https://api.attackontitanapi.com/characters/118"
    ],
    "allegiance": "Eldia"
  }
]

Filter titans

Available parameters:

name: Filter by name
allegiance: Filter by allegiance (Marley, Eldia or None).

GET https://api.attackontitanapi.com/titans?allegiance=marley

{
  "info": {
    "count": 4,
    "pages": 1,
    "next_page": null,
    "prev_page": null
  },
  "results": [
    {
      "id": 5,
      "name": "Armored Titan",
      "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/c/cf/Armored_Titan_%28Anime%29_character_image_%28Reiner_Braun%29.png/revision/latest/scale-to-width-down/350?cb=20170507070844",
      "height": "15m",
      "abilities": [
        "Armored skin",
        "Hardening"
      ],
      "current_inheritor": "https://api.attackontitanapi.com/characters/86",
      "former_inheritors": [],
      "allegiance": "Marley"
    },
    {
      "id": 6,
      "name": "Female Titan",
      "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/4/44/Female_Titan_%28Anime%29_character_image_%28Annie_Leonhart%29.png/revision/latest/scale-to-width-down/350?cb=20170708025046",
      "height": "14m",
      "abilities": [
        "Versatility",
        "Titan ",
        "Attraction",
        "Crystallization"
      ],
      "current_inheritor": "https://api.attackontitanapi.com/characters/87",
      "former_inheritors": [],
      "allegiance": "Marley"
    },
    // ...
  ]
}