# Attack on Titan API

> 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.

App · Film, TV & Fandom · 10 actions. Web page: https://docs.lodol.com/docs/integrations/attack-on-titan

## Actions

### Get a character

Get a single Attack on Titan character by id.

**Inputs**

- Character (`character_id`, text, required): 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**

- `character` (object)

**Example output**

```json
{
  "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**

- Location (`location_id`, text, required): Pick a location, or reference a location from a previous step by its ID or by one of the API's location URLs.

**Outputs**

- `location` (object)

**Example output**

```json
{
  "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**

- Titan (`titan_id`, text, required): 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**

- `titan` (object)

**Example output**

```json
{
  "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**

- Episode (`episode_id`, text, required): 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**

- `episode` (object)

**Example output**

```json
{
  "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**

- Organization (`organization_id`, text, required): Pick an organization, or reference an organization from a previous step by its ID or by one of the API's organization URLs.

**Outputs**

- `organization` (object)

**Example output**

```json
{
  "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**

- Name (`name`, text): Filter by character name (for example, Eren).
- Gender (`gender`, text): Filter by gender. One of: `male`, `female`, `unknown`.
- Status (`status`, text): Filter by whether the character is alive. One of: `alive`, `deceased`, `unknown`.
- Occupation (`occupation`, text): Filter by occupation (for example, soldier or thug).
- Page (`page`, number): Which page of results to return (defaults to the first page). Each page holds up to 20 results. At least 1.

**Outputs**

- `characters` (object)

**Example output**

```json
{
  "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**

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

**Outputs**

- `episodes` (object)

**Example output**

```json
{
  "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**

- Name (`name`, text): Filter by location name (for example, Dauper).
- Territory (`territory`, text): Filter by the territory the location sits in (for example, Shiganshina or Wall Rose).
- Region (`region`, text): Filter by region (for example, South).
- Page (`page`, number): Which page of results to return (defaults to the first page). Each page holds up to 20 results. At least 1.

**Outputs**

- `locations` (object)

**Example output**

```json
{
  "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**

- Name (`name`, text): Filter by organization name (for example, Warriors).
- Affiliation (`affiliation`, text): Filter by affiliation (for example, Marley, Warriors, Scouts, or unknown).
- Page (`page`, number): Which page of results to return (defaults to the first page). Each page holds up to 20 results. At least 1.

**Outputs**

- `organizations` (object)

**Example output**

```json
{
  "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**

- Name (`name`, text): Filter by titan name (for example, Armored Titan).
- Allegiance (`allegiance`, text): Filter by allegiance. One of: `marley`, `eldia`, `none`.
- Page (`page`, number): Which page of results to return (defaults to the first page). Each page holds up to 20 results. At least 1.

**Outputs**

- `titans` (object)

**Example output**

```json
{
  "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"
      }
    ]
  }
}
```