API

base.json i një seriali përmban të gjitha sezonet dhe episodet e tij, kështu që një kërkesë e vetme merr gjithë serialin. Emrat dhe përshkrimet e serialit, sezoneve dhe episodeve të tij janë në skedarët e gjuhëve.

Skedarët

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

Një imazh është një objekt me shtigjet full dhe thumb.

base.json

Fusha	Lloji	Përshkrimi
type	string	Lloji i regjistrimit.
id	number	Id-ja në TheTVDB.
slug	string	Slug-u i URL-së, unik brenda llojit.
popularity	number	Pikët e popullaritetit nga TheTVDB; më e lartë do të thotë më popullor. Pikët krahasohen vetëm brenda të njëjtit lloj.
deleted	boolean	True nëse regjistrimi është hequr. Skedarët e tij mbeten të publikuar.
firstAired	string	Data e episodit të parë (YYYY-MM-DD).
lastAired	string	Data e episodit më të fundit.
status	string	Statusi i transmetimit nga TheTVDB, si Continuing ose Ended.
network	string	Rrjeti televiziv.
originalLanguage	string	Kodi i gjuhës origjinale.
originalCountry	string	Vendi i origjinës (kod me tri shkronja).
image	image	Imazhi kryesor: poster për titujt, foto për personat.
images	{ [kind]: image }	Imazhi më i mirë i çdo lloji: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Për çdo lloj, imazhi më i mirë në secilën gjuhë, me kodin e gjuhës, madhësinë dhe pikët.
cast	credit[]	Aktorët, sipas renditjes në titra.
crew	credit[]	Të gjithë pjesëmarrësit e tjerë, me detyrën e tyre.
topBilledIds	number[]	Id-të e personave që shfaqen të parët.
seasons	season[]	Sezonet sipas renditjes së transmetimit, secili me episodet e veta.
genres	string[]	Slug-et e zhanreve, siç i përcakton TheTVDB.
languages	string[]	Gjuhët për të cilat regjistrimi ka skedarë.
remoteIds	{ [site]: string }	Id-të në sajte të tjera (imdb, tmdb, wikidata, …), me çelës sipas sajtit.

Shembull

{
  "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" }
}

Sezonet

Fusha	Lloji	Përshkrimi
id	number	Id-ja në TheTVDB.
number	number	Numri i sezonit; 0 janë episodet speciale.
deleted	boolean	True nëse regjistrimi është hequr. Skedarët e tij mbeten të publikuar.
image	image	Imazhi kryesor: poster për titujt, foto për personat.
images	{ [kind]: image }	Imazhi më i mirë i çdo lloji: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Për çdo lloj, imazhi më i mirë në secilën gjuhë, me kodin e gjuhës, madhësinë dhe pikët.
episodes	episode[]	Episodet e sezonit.

Episodet

Fusha	Lloji	Përshkrimi
id	number	Id-ja në TheTVDB.
number	number	Numri i episodit brenda sezonit.
aired	string	Data e transmetimit (YYYY-MM-DD).
runtime	number	Kohëzgjatja në minuta.
image	image	Imazhi kryesor: poster për titujt, foto për personat.
criticalToStory	boolean	I shënuar si thelbësor për historinë.
specialType	string	Çfarë lloj episodi special është (episodet e sezonit 0).
deleted	boolean	True nëse regjistrimi është hequr. Skedarët e tij mbeten të publikuar.

Pjesëmarrësit

Çdo element në cast dhe crew:

Fusha	Lloji	Përshkrimi
id	number	Id-ja e personit.
activityId	number	Id-ja e pjesëmarrjes, unike për çdo pjesëmarrje.
role	string	Personazhi i luajtur (aktorët).
job	string	Detyra (ekipi): director, writer, producer, …
slug	string	Slug-u i personit.
image	image	Fotoja e personit.
topBilled	boolean	Një pjesëmarrje e veçuar.
deleted	boolean	True nëse personi është hequr.

Skedarët e gjuhëve

Fusha	Lloji	Përshkrimi
type	string	Lloji i regjistrimit.
id	number	Id-ja në TheTVDB.
lang	string	Gjuha e këtij skedari.
name	string	Emri në këtë gjuhë.
overview	string	Përshkrimi në këtë gjuhë.
credits	{ [personId]: { name, role } }	Sipas id-së së personit: emri i tij në këtë gjuhë dhe roli i tij.
seasons	{ [seasonId]: { name, overview } }	Sipas id-së së sezonit: emri dhe përshkrimi i tij.
episodes	{ [episodeId]: { name, overview } }	Sipas id-së së episodit: emri dhe përshkrimi i tij.

Shembull

{
  "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…" } }
}

Gjetja e një titulli sipas slug-ut

URL-të e serialeve dhe filmave përdorin slug (breaking-bad). Indeksi i slug-eve lidh çdo slug me id-në e tij dhe është ndarë në 256 skedarë të vegjël: skedari i një slug-u emërtohet sipas dy karaktereve të para heksadecimale të hash-it SHA-1 të slug-ut.

// 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())