REST API · v1

Dub data for your app.

A simple JSON REST API. No auth needed for the first 100 requests per day. Batch up to 50 titles in one call.

BASE URL

https://api.anidub.dev

AUTHENTICATION

All endpoints work anonymously up to 100 requests per day (IP-based). For higher limits, include your API key in the X-Api-Key header.

Request

curl https://api.anidub.dev/v1/anime/21 \
  -H "X-Api-Key: your_key_here"

ENDPOINTS

GET/v1/anime/:anilist_id

200 OK

Returns full dub status for a single AniList title by its numeric ID.

PARAMETERS

anilist_idPATH

AniList numeric ID

languageQUERY

ISO 639-1 code. Default: "en"optional

ERROR RESPONSES

400INVALID_IDanilist_id is not a positive integer

404NOT_FOUNDNo title with that ID in the database

Request

curl https://api.anidub.dev/v1/anime/21

Response200 OK

{
  "animeId": "a1b2c3d4",
  "anilistId": 21,
  "malId": 21,
  "kitsuId": 12,
  "titleEnglish": "One Piece",
  "titleRomaji": "One Piece",
  "coverImage": "https://cdn.anilist.co/img/...",
  "dub": {
    "language": "en",
    "status": "dubbed",
    "confidence": 0.95,
    "lastVerifiedAt": "2024-12-01T00:00:00.000Z"
  }
}

POST/v1/anime/lookup

200 OK

Batch lookup — resolve up to 50 AniList IDs in a single request.

PARAMETERS

idsBODY

Array of AniList IDs (1–50 items)

languageBODY

ISO 639-1 code. Default: "en"optional

ERROR RESPONSES

400BAD_REQUESTRequest body is not valid JSON

400VALIDATION_ERRORids is missing, empty, or exceeds 50 items

Request

curl https://api.anidub.dev/v1/anime/lookup \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"ids": [21, 11061, 1535]}'

Response200 OK

{
  "results": [
    {
      "anilistId": 21,
      "titleEnglish": "One Piece",
      "dub": {
        "language": "en",
        "status": "dubbed",
        "confidence": 0.95,
        "lastVerifiedAt": "2024-12-01T00:00:00.000Z"
      }
    },
    {
      "anilistId": 11061,
      "titleEnglish": "Hunter x Hunter (2011)",
      "dub": {
        "language": "en",
        "status": "dubbed",
        "confidence": 0.95,
        "lastVerifiedAt": "2024-11-20T00:00:00.000Z"
      }
    }
  ],
  "notFound": [1535]
}

GET/v1/health

200 OK

Health check. Returns service status, current API version, and timestamp.

Request

curl https://api.anidub.dev/v1/health

Response200 OK

{
  "status": "ok",
  "version": "0.1.0",
  "timestamp": "2024-12-01T12:00:00.000Z"
}

RESPONSE SCHEMA

DubStatusResponse

FIELDTYPEDESCRIPTION

animeIdstringInternal database UUID

anilistIdnumberAniList title ID

malIdnumber | nullMyAnimeList ID

kitsuIdnumber | nullKitsu ID

titleEnglishstring | nullOfficial English title

titleRomajistring | nullRomanized Japanese title

coverImagestring | nullCover image URL (AniList CDN)

dubDubInfo | nullnull when no dub is tracked for the requested language

DubInfo

FIELDTYPEDESCRIPTION

languagestringISO 639-1 language code (e.g. "en")

statusDubStatusOne of the four status values — see below

confidencenumberScraper confidence score, 0–1

lastVerifiedAtstring | nullISO 8601 timestamp of last verified scrape

STATUS VALUES

dubbed

Full dub is available on streaming platforms

in_production

Studio confirmed; dubbing is actively in progress

announced

Dub is greenlit but recording has not started yet

none

No dub exists or has been confirmed

ERROR CODES

STATUSCODEDESCRIPTION

400INVALID_IDPath param anilist_id is not a positive integer

400BAD_REQUESTJSON body could not be parsed

400VALIDATION_ERRORBody schema failed — see error.message for detail

404NOT_FOUNDAnime ID not present in the database

500INTERNAL_ERRORUnexpected server error

All error responses share the shape: { error: string, code: string }

RATE LIMITS

TIERLIMITAPI KEYNOTES

Anonymous100 req / dayNoneIP-based

Free key1,000 req / dayRequiredanidub.dev/keys

Pro100,000 req / dayRequired$5 / month

ScaleUnlimitedRequiredContact us

ENDPOINTS

GET/v1/anime/:anilist_id

200 OK

Returns full dub status for a single AniList title by its numeric ID.

PARAMETERS

anilist_idPATH

AniList numeric ID

languageQUERY

ISO 639-1 code. Default: "en"optional

ERROR RESPONSES

400INVALID_IDanilist_id is not a positive integer

404NOT_FOUNDNo title with that ID in the database

Request

curl https://api.anidub.dev/v1/anime/21

Response200 OK

{
  "animeId": "a1b2c3d4",
  "anilistId": 21,
  "malId": 21,
  "kitsuId": 12,
  "titleEnglish": "One Piece",
  "titleRomaji": "One Piece",
  "coverImage": "https://cdn.anilist.co/img/...",
  "dub": {
    "language": "en",
    "status": "dubbed",
    "confidence": 0.95,
    "lastVerifiedAt": "2024-12-01T00:00:00.000Z"
  }
}

POST/v1/anime/lookup

200 OK

Batch lookup — resolve up to 50 AniList IDs in a single request.

PARAMETERS

idsBODY

Array of AniList IDs (1–50 items)

languageBODY

ISO 639-1 code. Default: "en"optional

ERROR RESPONSES

400BAD_REQUESTRequest body is not valid JSON

400VALIDATION_ERRORids is missing, empty, or exceeds 50 items

Request

curl https://api.anidub.dev/v1/anime/lookup \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"ids": [21, 11061, 1535]}'

Response200 OK

{
  "results": [
    {
      "anilistId": 21,
      "titleEnglish": "One Piece",
      "dub": {
        "language": "en",
        "status": "dubbed",
        "confidence": 0.95,
        "lastVerifiedAt": "2024-12-01T00:00:00.000Z"
      }
    },
    {
      "anilistId": 11061,
      "titleEnglish": "Hunter x Hunter (2011)",
      "dub": {
        "language": "en",
        "status": "dubbed",
        "confidence": 0.95,
        "lastVerifiedAt": "2024-11-20T00:00:00.000Z"
      }
    }
  ],
  "notFound": [1535]
}

GET/v1/health

200 OK

Health check. Returns service status, current API version, and timestamp.

Request

curl https://api.anidub.dev/v1/health

Response200 OK

{
  "status": "ok",
  "version": "0.1.0",
  "timestamp": "2024-12-01T12:00:00.000Z"
}

RESPONSE SCHEMA

DubStatusResponse

FIELDTYPEDESCRIPTION

animeIdstringInternal database UUID

anilistIdnumberAniList title ID

malIdnumber | nullMyAnimeList ID

kitsuIdnumber | nullKitsu ID

titleEnglishstring | nullOfficial English title

titleRomajistring | nullRomanized Japanese title

coverImagestring | nullCover image URL (AniList CDN)

dubDubInfo | nullnull when no dub is tracked for the requested language

DubInfo

FIELDTYPEDESCRIPTION

languagestringISO 639-1 language code (e.g. "en")

statusDubStatusOne of the four status values — see below

confidencenumberScraper confidence score, 0–1

lastVerifiedAtstring | nullISO 8601 timestamp of last verified scrape

ERROR CODES

STATUSCODEDESCRIPTION

400INVALID_IDPath param anilist_id is not a positive integer

400BAD_REQUESTJSON body could not be parsed

400VALIDATION_ERRORBody schema failed — see error.message for detail

404NOT_FOUNDAnime ID not present in the database

500INTERNAL_ERRORUnexpected server error

All error responses share the shape: { error: string, code: string }