Resolve a Kodik embed iframe URL by external id

GET

/api/v1/embed/{idType}/{id}

const url = 'http://localhost:8080/api/v1/embed/shikimori/20';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:8080/api/v1/embed/shikimori/20

Calls Kodik’s /get-player helper and returns the resolved kodikplayer.com iframe URL plus minimal metadata. The endpoint is read-only — it does not write to the database and does not trigger the video decoder. Use /api/v1/parse/search if you also want to ingest the content.

Supported idType values (snake_case or kebab-case accepted):

shikimori — Shikimori id (numeric, e.g. 20)
kinopoisk — Kinopoisk id (numeric)
imdb — IMDb id; the tt prefix is added automatically when missing
mdl — MyDramaList id
kodik — native Kodik id, must be supplied as serial-{n} or movie-{n}
worldart_animation — World Art animation id
worldart_cinema — World Art cinema id

Auth: subject to X-API-KEY when orinuno.security.api-key is configured.

Parameters

Path Parameters

idType

required

string

External id source

Example

shikimori

required

string

External id value

Example

Responses

200

Embed resolved

application/json

Resolved Kodik embed (iframe) URL plus metadata for the requested id.

object

idType

string

Allowed values: shikimori kinopoisk imdb mdl kodik worldart_animation worldart_cinema

requestedId

string

normalizedId

string

embedLink

string

mediaType

string | null

Example

{
  "idType": "shikimori",
  "requestedId": "20",
  "normalizedId": "20",
  "embedLink": "https://kodikplayer.com/serial/73959/68e2e57cb95f7fb93655637acaca26c2/720p",
  "mediaType": "serial"
}

400

Unknown idType or empty id

application/json

404

Kodik has no player for the supplied id

application/json

502

Kodik returned a non-recoverable upstream error

application/json

503

No working Kodik token available

application/json