Skip to content
GET /v1/character

Character by id or search

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/anilist-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/anilist-api/v1/character" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/anilist-api/v1/character", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/anilist-api/v1/character");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/anilist-api/v1/character",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "character": {
            "id": 417,
            "age": "17-18",
            "url": "https://anilist.co/character/417",
            "name": "Lelouch Lamperouge",
            "image": "https://s4.anilist.co/file/anilistcdn/character/large/b417-gVLmIJu9phcK.png",
            "gender": "Male",
            "native": "ルルーシュ・ランペルージ",
            "aliases": [
                "Lulu",
                "Zero",
                "King of Elevens",
                "The Demon",
                "Black King",
                "Black Demon",
                "Julius Kingsley"
            ],
            "appears_in": [
                {
                    "id": 1575,
                    "type": "ANIME",
                    "title": "Code Geass: Lelouch of the Rebellion"
                },
                {
                    "id": 2904,
                    "type": "ANIME",
                    "title": "Code Geass: Lelouch of the Rebellion R2"
                },
                {
                    "id": 97880,
                    "type": "ANIME",
                    "title": "Code Geass: Lelouch of the Re;surrection"
                },
                {
                    "id": 126830,
                    "type": "ANIME",
                    "title": "Code Geass: Rozé of the Recapture"
                },
                {
                    "id": 101811,
                    "type": "ANIME",
                    "title": "Code Geass: Lelouch of the Rebellion I - Initiation"
                },
                {
                    "id": 15197,
                    "type": "ANIME",
                    "title": "Code Geass: Akito the Exiled - The Wyvern Divided"
                },
                {
                    "id": 101813,
                    "type": "ANIME",
                    "title": "Code Geass: Lelouch of the Rebellion III - Glorification"
                },
                {
                    "id": 15199,
                    "type": "ANIME",
                    "title": "Code Geass: Akito the Exiled - The Brightness Falls"
                }
            ],
            "favourites": 27796,
            "description": "__Nationality:__ Britannian\n__Height:__ 178 - 183 cm \n__Relatives:__ Nunnally Lamperouge\n__Allegiance:__ Order of the Black Knights\n__Position:__ Order of the Black Knights Leader\n__Knightmare Frame:__ Burai, Gawain, Shinkiro, Sutherland  \n\n\nLelouch is a student of Ashford Academy high school, where he is a member of its student council. A brilliant thinker who is quite talented at chess, he lives with his younger sister, Nunnally, with their maid, [Sayoko Shinozaki](https://anilist.co/character/1807), at a house situated within the compounds of Ashford Academy, where they are looked after by the Ashford family.  Lelouch is soon swept into the conflict between the Britannia Empire and the pockets of resistance which oppose it when he accidentally boards a truck being used by Japanese resistance operatives. W
…