API

base.json на сериала съдържа всички негови сезони и епизоди, така че една заявка връща целия сериал. Имената и описанията на сериала, сезоните и епизодите му са в езиковите файлове.

Файлове

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

Изображението е обект с пътища full и thumb.

base.json

Поле	Тип	Описание
type	string	Тип на записа.
id	number	Id в TheTVDB.
slug	string	Слъг за URL адреса, уникален в рамките на типа.
popularity	number	Оценка за популярност от TheTVDB; по-висока означава по-популярен. Оценките са сравними само в рамките на един тип.
deleted	boolean	True, ако записът е премахнат. Файловете му остават публикувани.
firstAired	string	Дата на първия епизод (YYYY-MM-DD).
lastAired	string	Дата на последния епизод.
status	string	Статус на излъчване от TheTVDB, например Continuing или Ended.
network	string	Телевизия.
originalLanguage	string	Код на оригиналния език.
originalCountry	string	Държава на произход (трибуквен код).
image	image	Основно изображение: плакат за заглавията, снимка за личностите.
images	{ [kind]: image }	Най-доброто изображение от всеки вид: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	За всеки вид: най-доброто изображение на всеки език, с езиков код, размер и оценка.
cast	credit[]	Актьори, по реда в надписите.
crew	credit[]	Всички останали участници, с длъжността им.
topBilledIds	number[]	Id на личностите, които да се показват първи.
seasons	season[]	Сезони по реда на излъчване, всеки с епизодите си.
genres	string[]	Слъгове на жанровете, както ги определя TheTVDB.
languages	string[]	Езици, за които записът има файлове.
remoteIds	{ [site]: string }	Id в други сайтове (imdb, tmdb, wikidata, …), с ключ по сайт.

Пример

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

Сезони

Поле	Тип	Описание
id	number	Id в TheTVDB.
number	number	Номер на сезона; 0 означава специални епизоди.
deleted	boolean	True, ако записът е премахнат. Файловете му остават публикувани.
image	image	Основно изображение: плакат за заглавията, снимка за личностите.
images	{ [kind]: image }	Най-доброто изображение от всеки вид: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	За всеки вид: най-доброто изображение на всеки език, с езиков код, размер и оценка.
episodes	episode[]	Епизодите на сезона.

Епизоди

Поле	Тип	Описание
id	number	Id в TheTVDB.
number	number	Номер на епизода в сезона.
aired	string	Дата на излъчване (YYYY-MM-DD).
runtime	number	Продължителност в минути.
image	image	Основно изображение: плакат за заглавията, снимка за личностите.
criticalToStory	boolean	Отбелязан като важен за сюжета.
specialType	string	Вид специален епизод (епизоди от сезон 0).
deleted	boolean	True, ако записът е премахнат. Файловете му остават публикувани.

Участници

Всеки елемент в cast и crew:

Поле	Тип	Описание
id	number	Id на личността.
activityId	number	Id на участието, уникален за всяко участие.
role	string	Изигран персонаж (актьори).
job	string	Длъжност (екип): director, writer, producer, …
slug	string	Слъгът на личността.
image	image	Снимката на личността.
topBilled	boolean	Отличено участие.
deleted	boolean	True, ако личността е премахната.

Езикови файлове

Поле	Тип	Описание
type	string	Тип на записа.
id	number	Id в TheTVDB.
lang	string	Език на този файл.
name	string	Име на този език.
overview	string	Описание на този език.
credits	{ [personId]: { name, role } }	По id на личност: името ѝ на този език и ролята ѝ.
seasons	{ [seasonId]: { name, overview } }	По id на сезон: името и описанието му.
episodes	{ [episodeId]: { name, overview } }	По id на епизод: името и описанието му.

Пример

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

Намиране на заглавие по слъг

URL адресите на сериали и филми използват слъгове (breaking-bad). Индексът на слъговете съпоставя всеки слъг с неговия id и е разделен на 256 малки файла: файлът на даден слъг е наречен по първите два шестнадесетични знака от SHA-1 на слъга.

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