API

base.json фильма содержит данные, не зависящие от языка, и участников; названия и описания находятся в языковых файлах.

Файлы

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

Изображение: объект с путями full и thumb.

base.json

Поле	Тип	Описание
type	string	Тип записи.
id	number	Id в TheTVDB.
slug	string	Слаг для URL, уникальный в пределах типа.
popularity	number	Оценка популярности TheTVDB; чем выше, тем популярнее. Оценки сравнимы только в пределах одного типа.
deleted	boolean	True, если запись удалена. Её файлы остаются опубликованными.
released	string	Дата выхода (YYYY-MM-DD).
runtime	number	Продолжительность в минутах.
image	image	Основное изображение: постер для тайтлов, фото для персон.
images	{ [kind]: image }	Лучшее изображение каждого вида: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Для каждого вида: лучшее изображение на каждом языке, с кодом языка, размером и оценкой.
cast	credit[]	Актёры в порядке указания в титрах.
crew	credit[]	Все остальные участники с их должностями.
topBilledIds	number[]	Id персон, которых нужно показывать первыми.
genres	string[]	Слаги жанров в том виде, в каком их определяет TheTVDB.
languages	string[]	Языки, для которых у записи есть файлы.
remoteIds	{ [site]: string }	Id на других сайтах (imdb, tmdb, wikidata, …) с ключом по сайту.

Пример

{
  "type": "movie",
  "id": 16612,
  "slug": "barbie",
  "popularity": 1213687,
  "deleted": false,
  "released": "2023-07-18",
  "runtime": 114,
  "images": {
    "poster": { "full": "/images/movie/16612/poster/64ba61bb1dc73.jpg", "thumb": "/images/movie/16612/poster/64ba61bb1dc73.t.jpg" }
  },
  "imagesByLang": {
    "poster": [{ "full": "/images/movie/16612/poster/64ba61bb1dc73.jpg", "thumb": "…", "lang": "eng", "width": 680, "height": 1000, "score": 100007 }]
  },
  "cast": [
    { "id": 327479, "activityId": 44, "role": "Barbie", "slug": "margot-robbie", "topBilled": true, "deleted": false }
  ],
  "crew": [
    { "id": 569546, "activityId": 93, "job": "producer", "slug": "walter-f-parkes", "topBilled": false, "deleted": false }
  ],
  "topBilledIds": [327479],
  "genres": ["adventure", "comedy", "fantasy"],
  "languages": ["de", "en", "fr"],
  "remoteIds": { "imdb": "tt1517268", "tmdb": "346698" }
}

Участники

Каждый элемент в 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 персоны: её имя на этом языке и её роль.

Пример

{
  "type": "movie",
  "id": 16612,
  "lang": "en",
  "name": "Barbie",
  "overview": "Barbie and Ken are having the time of their lives…",
  "credits": { "327479": { "name": "Margot Robbie", "role": "Barbie" } }
}

Поиск тайтла по слагу

URL сериалов и фильмов используют слаги (breaking-bad). Индекс слагов сопоставляет каждому слагу его id и разбит на 256 небольших файлов: имя файла слага состоит из первых двух шестнадцатеричных символов SHA-1 от слага.

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

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