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