Skip to content
GET /v1/characters

The characters in a title, with voice actors

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

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

Get an API key

Code snippets

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

Example response

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

{
    "data": {
        "count": 4,
        "source": "Bangumi public v0 API (api.bgm.tv/v0/subjects/<id>/characters), keyless",
        "characters": [
            {
                "id": 2166,
                "name": "シャノア",
                "image": "https://lain.bgm.tv/pic/crt/g/6d/f9/2166_crt_sj4vw.jpg",
                "actors": [
                    "桑島法子"
                ],
                "relation": "主角"
            },
            {
                "id": 2167,
                "name": "アルバス",
                "image": "https://lain.bgm.tv/pic/crt/g/8f/07/2167_crt_AAzih.jpg",
                "actors": [
                    "関俊彦"
                ],
                "relation": "配角"
            },
            {
                "id": 2168,
                "name": "バーロウ",
                "image": "https://lain.bgm.tv/pic/crt/g/c8/de/2168_crt_Z2AaT.jpg",
                "actors": [
                    "石井康嗣"
                ],
                "relation": "配角"
            },
            {
                "id": 10845,
                "name": "ドラキュラ",
                "image": "https://lain.bgm.tv/pic/crt/g/ba/9f/10845_crt_OGLit.jpg",
                "actors": [
                    "若本規夫"
                ],
                "relation": "配角"
            }
        ],
        "subject_id": 25
    },
    "meta": {
        "timestamp": "2026-06-13T13:47:55.855Z",
        "request_id": "2bd7126e-8cac-46e1-88f9-bab694a80b35"
    },
    "status": "ok",
    "message": "Characters retrieved successfully",
    "success": true
}