API

Egy sorozat base.json fájlja tartalmazza az összes évadot és epizódot, így egyetlen kéréssel az egész sorozat letölthető. A sorozat, az évadok és az epizódok nevei és leírásai a nyelvi fájlokban vannak.

Fájlok

https://api.watchittrackit.com/v1/tv/{id}/base.json
https://api.watchittrackit.com/v1/tv/{id}/{lang}.json
https://api.watchittrackit.com/v1/tv/slugs/{shard}.json

A kép egy objektum full és thumb elérési úttal.

base.json

Mező	Típus	Leírás
type	string	A rekord típusa.
id	number	TheTVDB-azonosító.
slug	string	URL-slug, a típuson belül egyedi.
popularity	number	TheTVDB népszerűségi pontszám; a magasabb népszerűbbet jelent. A pontszámok csak egy típuson belül hasonlíthatók össze.
deleted	boolean	True, ha a rekordot törölték. A fájljai elérhetők maradnak.
firstAired	string	Az első epizód dátuma (YYYY-MM-DD).
lastAired	string	A legutóbbi epizód dátuma.
status	string	Sugárzási állapot a TheTVDB-ből, például Continuing vagy Ended.
network	string	Csatorna.
originalLanguage	string	Az eredeti nyelv kódja.
originalCountry	string	Származási ország (hárombetűs kód).
image	image	Fő kép: címeknél plakát, személyeknél fotó.
images	{ [kind]: image }	Minden fajtából a legjobb kép: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Fajtánként a legjobb kép minden nyelven, a nyelvkóddal, mérettel és pontszámmal.
cast	credit[]	Színészek a stáblista sorrendjében.
crew	credit[]	Minden további közreműködő a munkakörével.
topBilledIds	number[]	Az elsőként kiemelendő személyek azonosítói.
seasons	season[]	Évadok sugárzási sorrendben, mindegyik az epizódjaival.
genres	string[]	Műfaj-slugok a TheTVDB meghatározása szerint.
languages	string[]	Azok a nyelvek, amelyekhez a rekordnak van fájlja.
remoteIds	{ [site]: string }	Azonosítók más oldalakon (imdb, tmdb, wikidata, …), oldal szerint.

Példa

{
  "type": "tv",
  "id": 81189,
  "slug": "breaking-bad",
  "popularity": 3287090,
  "deleted": false,
  "firstAired": "2008-01-20",
  "lastAired": "2013-09-29",
  "status": "Ended",
  "images": {
    "poster": { "full": "/images/tv/81189/1340353429.jpg", "thumb": "/images/tv/81189/1340353429.t.jpg" }
  },
  "cast": [
    { "id": 255211, "activityId": 180, "role": "Walter White", "slug": "bryan-cranston", "topBilled": false, "deleted": false }
  ],
  "seasons": [
    {
      "id": 30272, "number": 1, "deleted": false,
      "episodes": [{ "id": 349232, "number": 1, "aired": "2008-01-20", "runtime": 58, "deleted": false }]
    }
  ],
  "genres": ["drama", "crime"],
  "languages": ["de", "en", "fr"],
  "remoteIds": { "imdb": "tt0903747" }
}

Évadok

Mező	Típus	Leírás
id	number	TheTVDB-azonosító.
number	number	Az évad száma; a 0 a különkiadásoké.
deleted	boolean	True, ha a rekordot törölték. A fájljai elérhetők maradnak.
image	image	Fő kép: címeknél plakát, személyeknél fotó.
images	{ [kind]: image }	Minden fajtából a legjobb kép: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Fajtánként a legjobb kép minden nyelven, a nyelvkóddal, mérettel és pontszámmal.
episodes	episode[]	Az évad epizódjai.

Epizódok

Mező	Típus	Leírás
id	number	TheTVDB-azonosító.
number	number	Az epizód száma az évadon belül.
aired	string	Sugárzás dátuma (YYYY-MM-DD).
runtime	number	Hossz percben.
image	image	Fő kép: címeknél plakát, személyeknél fotó.
criticalToStory	boolean	A történet szempontjából lényegesként megjelölve.
specialType	string	A különkiadás fajtája (a 0. évad epizódjai).
deleted	boolean	True, ha a rekordot törölték. A fájljai elérhetők maradnak.

Stáblista

A cast és crew minden eleme:

Mező	Típus	Leírás
id	number	A személy azonosítója.
activityId	number	A közreműködés azonosítója, közreműködésenként egyedi.
role	string	Alakított szereplő (szereplők).
job	string	Munkakör (stáb): director, writer, producer, …
slug	string	A személy slugja.
image	image	A személy fotója.
topBilled	boolean	Kiemelt közreműködés.
deleted	boolean	True, ha a személyt törölték.

Nyelvi fájlok

Mező	Típus	Leírás
type	string	A rekord típusa.
id	number	TheTVDB-azonosító.
lang	string	A fájl nyelve.
name	string	Név ezen a nyelven.
overview	string	Leírás ezen a nyelven.
credits	{ [personId]: { name, role } }	Személyazonosítónként: a személy neve ezen a nyelven és a szerepe.
seasons	{ [seasonId]: { name, overview } }	Évadazonosítónként: az évad neve és leírása.
episodes	{ [episodeId]: { name, overview } }	Epizódazonosítónként: az epizód neve és leírása.

Példa

{
  "type": "tv",
  "id": 81189,
  "lang": "en",
  "name": "Breaking Bad",
  "overview": "When Walter White, a chemistry teacher, …",
  "credits": { "255211": { "name": "Bryan Cranston", "role": "Walter White" } },
  "seasons": { "30272": { "overview": "High school chemistry teacher Walter White…" } },
  "episodes": { "349232": { "name": "Pilot", "overview": "When an unassuming high school chemistry teacher…" } }
}

Cím keresése slug alapján

A sorozatok és filmek URL-jei slugokat használnak (breaking-bad). A slugindex minden slughoz hozzárendeli az azonosítóját, és 256 kis fájlra van felosztva: egy slug fájljának neve a slug SHA-1 értékének első két hexadecimális karaktere.

// Node.js
import { createHash } from "node:crypto"

const slug = "breaking-bad"
const shard = createHash("sha1").update(slug, "utf8").digest("hex").slice(0, 2)
const index = await fetch(`https://api.watchittrackit.com/v1/tv/slugs/${shard}.json`).then((r) => r.json())
const id = index[slug]
const record = await fetch(`https://api.watchittrackit.com/v1/tv/${id}/base.json`).then((r) => r.json())