Attack on Titan API

App · Film, TV & Fandom · 10 actions

Look up Attack on Titan data using the free, keyless Attack on Titan API: browse and filter characters, episodes, locations, organizations, and the Nine Titans, and fetch any single record by id. No account or API key required. Disclaimer: this is an independent integration with the community-run Attack on Titan API (attackontitanapi.com). It is not affiliated with, endorsed by, or sponsored by Hajime Isayama, Kodansha, MAPPA, WIT Studio, or Crunchyroll; Attack on Titan and all related names, characters, and trademarks are the property of their respective owners.

Actions

ActionWhat it does
Get a characterGet a single Attack on Titan character by id.
Get a locationGet a single Attack on Titan location by id.
Get a titanGet a single one of the Nine Titans by id.
Get an episodeGet a single Attack on Titan episode by id.
Get an organizationGet a single Attack on Titan organization by id.
List charactersList Attack on Titan characters, optionally filtered by name, gender, status, or occupation.
List episodesList Attack on Titan episodes, optionally filtered by name or episode code.
List locationsList Attack on Titan locations, optionally filtered by name, territory, or region.
List organizationsList Attack on Titan organizations, optionally filtered by name or affiliation.
List titansList the Nine Titans, optionally filtered by name or allegiance.

Get a character

Get a single Attack on Titan character by id.

Inputs

Charactercharacter_idtextRequired
Pick a character, or reference a character from a previous step by its ID or by one of the API's character URLs (an entry from an episode's 'characters', say).

Outputs

characterobject
Example output
{
  "character": {
    "age": 19,
    "alias": [
      "Suicidal Maniac",
      "Attack Titan",
      "Founding Titan"
    ],
    "birthplace": "Shiganshina District",
    "episodes": [
      "https://api.attackontitanapi.com/episodes/1",
      "https://api.attackontitanapi.com/episodes/2"
    ],
    "gender": "Male",
    "groups": [],
    "height": "15 m (Titan form)",
    "id": 188,
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/a1/Eren_Jaeger_%28Anime%29_character_image.png",
    "name": "Eren Jaeger",
    "occupation": "Soldier",
    "relatives": [
      {
        "family": "Jaeger family",
        "members": [
          "https://api.attackontitanapi.com/characters/160",
          "https://api.attackontitanapi.com/characters/161"
        ]
      }
    ],
    "residence": "Wall Rose",
    "roles": [
      "Attack Titans",
      "Founding Titans",
      "War Hammer Titans"
    ],
    "species": [
      "Human",
      "Intelligent Titan"
    ],
    "status": "Alive"
  }
}

Get a location

Get a single Attack on Titan location by id.

Inputs

Locationlocation_idtextRequired
Pick a location, or reference a location from a previous step by its ID or by one of the API's location URLs.

Outputs

locationobject
Example output
{
  "location": {
    "debut": "https://api.attackontitanapi.com/episodes/10",
    "id": 1,
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/9/90/Anime_basement.png",
    "name": "Basement",
    "notable_former_inhabitants": [],
    "notable_inhabitants": [],
    "region": "South",
    "territory": "Shiganshina District"
  }
}

Get a titan

Get a single one of the Nine Titans by id.

Inputs

Titantitan_idtextRequired
Pick a titan, or reference a titan from a previous step by its ID or by one of the API's titan URLs (an episode's 'characters' list can include them).

Outputs

titanobject
Example output
{
  "titan": {
    "abilities": [
      "Future memory inheritance"
    ],
    "allegiance": "Eldia",
    "current_inheritor": "https://api.attackontitanapi.com/characters/188",
    "former_inheritors": [
      "https://api.attackontitanapi.com/characters/160",
      "https://api.attackontitanapi.com/characters/98"
    ],
    "height": "15m",
    "id": 1,
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/ae/Attack_Titan_%28Anime%29_character_image_%28Eren_Jaeger%29.png",
    "name": "Attack Titan"
  }
}

Get an episode

Get a single Attack on Titan episode by id.

Inputs

Episodeepisode_idtextRequired
Pick an episode, or reference an episode from a previous step by its ID or by one of the API's episode URLs (a location's 'debut', say).

Outputs

episodeobject
Example output
{
  "episode": {
    "characters": [
      "https://api.attackontitanapi.com/characters/188",
      "https://api.attackontitanapi.com/characters/1"
    ],
    "episode": "S01E01",
    "id": 1,
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/b/b4/The_Colossal_Titan_outside_Shiganshina.png",
    "name": "To You, in 2000 Years: The Fall of Shiganshina, Part 1"
  }
}

Get an organization

Get a single Attack on Titan organization by id.

Inputs

Organizationorganization_idtextRequired
Pick an organization, or reference an organization from a previous step by its ID or by one of the API's organization URLs.

Outputs

organizationobject
Example output
{
  "organization": {
    "affiliation": "Marleyan military",
    "debut": "https://api.attackontitanapi.com/episodes/29",
    "id": 17,
    "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/4/4f/Warriors_%28854%29.png",
    "name": "Warriors",
    "notable_former_members": [],
    "notable_members": [
      "https://api.attackontitanapi.com/characters/86",
      "https://api.attackontitanapi.com/characters/87"
    ],
    "occupations": [
      "Titan Warriors act as the main assault force in ground-based combat",
      "Acted as spies in the Paradis Island Operation."
    ]
  }
}

List characters

List Attack on Titan characters, optionally filtered by name, gender, status, or occupation. Each character comes with their aliases, species, age, birthplace, residence, relatives, groups, roles, and the episodes they appear in. Results are paginated with up to 20 characters per page.

Inputs

Namenametext
Filter by character name (for example, Eren).
Gendergendertext
Filter by gender.One of: male, female, unknown.
Statusstatustext
Filter by whether the character is alive.One of: alive, deceased, unknown.
Occupationoccupationtext
Filter by occupation (for example, soldier or thug).
Pagepagenumber
Which page of results to return (defaults to the first page). Each page holds up to 20 results.At least 1.

Outputs

charactersobject
Example output
{
  "characters": {
    "info": {
      "count": 201,
      "next_page": "https://api.attackontitanapi.com/characters?page=2",
      "pages": 11,
      "prev_page": null
    },
    "results": [
      {
        "age": 19,
        "alias": [
          "Suicidal Maniac",
          "Attack Titan",
          "Founding Titan"
        ],
        "birthplace": "Shiganshina District",
        "episodes": [
          "https://api.attackontitanapi.com/episodes/1",
          "https://api.attackontitanapi.com/episodes/2"
        ],
        "gender": "Male",
        "groups": [],
        "height": "15 m (Titan form)",
        "id": 188,
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/a1/Eren_Jaeger_%28Anime%29_character_image.png",
        "name": "Eren Jaeger",
        "occupation": "Soldier",
        "relatives": [
          {
            "family": "Jaeger family",
            "members": [
              "https://api.attackontitanapi.com/characters/160",
              "https://api.attackontitanapi.com/characters/161"
            ]
          }
        ],
        "residence": "Wall Rose",
        "roles": [
          "Attack Titans",
          "Founding Titans",
          "War Hammer Titans"
        ],
        "species": [
          "Human",
          "Intelligent Titan"
        ],
        "status": "Alive"
      }
    ]
  }
}

List episodes

List Attack on Titan episodes, optionally filtered by name or episode code. Each episode comes with its image and the characters that appear in it. Results are paginated with up to 20 episodes per page.

Inputs

Namenametext
Filter by episode name (for example, The Dawn of Humanity).
Episode codeepisodetext
Filter by episode code, spelled the way this action returns it on an episode. A leading part of the code matches a whole season.
Pagepagenumber
Which page of results to return (defaults to the first page). Each page holds up to 20 results.At least 1.

Outputs

episodesobject
Example output
{
  "episodes": {
    "info": {
      "count": 88,
      "next_page": "https://api.attackontitanapi.com/episodes?page=2",
      "pages": 5,
      "prev_page": null
    },
    "results": [
      {
        "characters": [
          "https://api.attackontitanapi.com/characters/188",
          "https://api.attackontitanapi.com/characters/1"
        ],
        "episode": "S01E01",
        "id": 1,
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/b/b4/The_Colossal_Titan_outside_Shiganshina.png",
        "name": "To You, in 2000 Years: The Fall of Shiganshina, Part 1"
      }
    ]
  }
}

List locations

List Attack on Titan locations, optionally filtered by name, territory, or region. Each location comes with its notable inhabitants, former inhabitants, and the episode it debuted in. Results are paginated with up to 20 locations per page.

Inputs

Namenametext
Filter by location name (for example, Dauper).
Territoryterritorytext
Filter by the territory the location sits in (for example, Shiganshina or Wall Rose).
Regionregiontext
Filter by region (for example, South).
Pagepagenumber
Which page of results to return (defaults to the first page). Each page holds up to 20 results.At least 1.

Outputs

locationsobject
Example output
{
  "locations": {
    "info": {
      "count": 36,
      "next_page": "https://api.attackontitanapi.com/locations?page=2",
      "pages": 2,
      "prev_page": null
    },
    "results": [
      {
        "debut": "https://api.attackontitanapi.com/episodes/10",
        "id": 1,
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/9/90/Anime_basement.png",
        "name": "Basement",
        "notable_former_inhabitants": [],
        "notable_inhabitants": [],
        "region": "South",
        "territory": "Shiganshina District"
      }
    ]
  }
}

List organizations

List Attack on Titan organizations, optionally filtered by name or affiliation. Each organization comes with its occupations, notable members, former members, and the episode it debuted in. Results are paginated with up to 20 organizations per page.

Inputs

Namenametext
Filter by organization name (for example, Warriors).
Affiliationaffiliationtext
Filter by affiliation (for example, Marley, Warriors, Scouts, or unknown).
Pagepagenumber
Which page of results to return (defaults to the first page). Each page holds up to 20 results.At least 1.

Outputs

organizationsobject
Example output
{
  "organizations": {
    "info": {
      "count": 17,
      "next_page": null,
      "pages": 1,
      "prev_page": null
    },
    "results": [
      {
        "affiliation": "Marleyan military",
        "debut": "https://api.attackontitanapi.com/episodes/29",
        "id": 17,
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/4/4f/Warriors_%28854%29.png",
        "name": "Warriors",
        "notable_former_members": [],
        "notable_members": [
          "https://api.attackontitanapi.com/characters/86",
          "https://api.attackontitanapi.com/characters/87"
        ],
        "occupations": [
          "Titan Warriors act as the main assault force in ground-based combat",
          "Acted as spies in the Paradis Island Operation."
        ]
      }
    ]
  }
}

List titans

List the Nine Titans, optionally filtered by name or allegiance. Each titan comes with its height, abilities, current inheritor, and former inheritors.

Inputs

Namenametext
Filter by titan name (for example, Armored Titan).
Allegianceallegiancetext
Filter by allegiance.One of: marley, eldia, none.
Pagepagenumber
Which page of results to return (defaults to the first page). Each page holds up to 20 results.At least 1.

Outputs

titansobject
Example output
{
  "titans": {
    "info": {
      "count": 9,
      "next_page": null,
      "pages": 1,
      "prev_page": null
    },
    "results": [
      {
        "abilities": [
          "Future memory inheritance"
        ],
        "allegiance": "Eldia",
        "current_inheritor": "https://api.attackontitanapi.com/characters/188",
        "former_inheritors": [
          "https://api.attackontitanapi.com/characters/160",
          "https://api.attackontitanapi.com/characters/98"
        ],
        "height": "15m",
        "id": 1,
        "img": "https://static.wikia.nocookie.net/shingekinokyojin/images/a/ae/Attack_Titan_%28Anime%29_character_image_%28Eren_Jaeger%29.png",
        "name": "Attack Titan"
      }
    ]
  }
}

On this page