Skip to content
GET /v1/search/characters

Search characters

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/vndb-api

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

Get an API key

Code snippets

curl "https://api.oanor.com/vndb-api/v1/search/characters" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/vndb-api/v1/search/characters", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/vndb-api/v1/search/characters");
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/vndb-api/v1/search/characters",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "more": true,
        "count": 20,
        "query": "saber",
        "characters": [
            {
                "id": "c33",
                "age": null,
                "sex": "f",
                "url": "https://vndb.org/c33",
                "vns": [
                    {
                        "id": "v11",
                        "role": "primary",
                        "title": "Fate/stay night"
                    },
                    {
                        "id": "v50",
                        "role": "primary",
                        "title": "Fate/hollow ataraxia"
                    },
                    {
                        "id": "v666",
                        "role": "appears",
                        "title": "Twinkle ☆ Crusaders"
                    },
                    {
                        "id": "v14554",
                        "role": "primary",
                        "title": "Fate/Zero The Adventure"
                    }
                ],
                "name": "Saber",
                "image": "https://t.vndb.org/ch/34/34.jpg",
                "height": 154,
                "aliases": [
                    "Altria Pendragon",
                    "アルトリア・ペンドラゴン",
                    "Artoria Pendragon"
                ],
                "original": "セイバー",
                "blood_type": "o",
                "description": "Saber is [url=/c15]Shirou's[/url] Servant. Loyal, independent, and reserved, Saber acts coldly but is actually suppressing her emotions to focus on her goals.\n\nHer class is considered the \"Most Outstanding\" with excellent ratings in all categories. Since her Master cannot adequately provide her with Mana, she minimizes her activity to preserve her energy. Saber is frustrated by Shirou's \"protective\" tendencies, believing his erratic and reckless behavior will jeopardize her chances of winning the Holy Grail War.\n\nHer real name is [spoiler]Artoria Pendragon/Altria Pendragon, the legendary King Arthur.[/spoiler]\n\n[From [url=http://en.wikipedia.org/wiki/List_of_Fate/stay_night_characters]Wikipedia[/url]]"
            },
            {
                "id": "c54",
                "age": null,
                "sex": "f",
                "url": "https://vndb.org/c54",
                "vns": [
                    {
                        "id": "v11",
                        "role": "side",
                        "title": "Fate/stay night"
                    },
                    {
                        "id": "v50",
                        "role": "appears",
                        "title": "Fate/hollow ataraxia"
                    }
                ],
                "name": "Saber Alter",
                "image": "https://t.vndb.org/ch/57/57.jpg",
                "height": 154,
                "aliases": [
                    "Dark Saber"
                ],
                "original": "セイバー・オルタナティブ",
                "blood_type": null,
             
…