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