API

Plik base.json serialu zawiera wszystkie jego sezony i odcinki, więc jedno zapytanie pobiera cały serial. Nazwy i opisy serialu, sezonów i odcinków są w plikach językowych.

Pliki

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

Obraz to obiekt ze ścieżkami full i thumb.

base.json

Pole	Typ	Opis
type	string	Typ rekordu.
id	number	Id z TheTVDB.
slug	string	Slug URL, unikalny w obrębie typu.
popularity	number	Wynik popularności z TheTVDB; wyższy oznacza popularniejszy. Wyniki można porównywać tylko w obrębie jednego typu.
deleted	boolean	True, jeśli rekord został usunięty. Jego pliki pozostają opublikowane.
firstAired	string	Data pierwszego odcinka (YYYY-MM-DD).
lastAired	string	Data najnowszego odcinka.
status	string	Status emisji z TheTVDB, np. Continuing lub Ended.
network	string	Stacja.
originalLanguage	string	Kod języka oryginału.
originalCountry	string	Kraj pochodzenia (kod trzyliterowy).
image	image	Główny obraz: plakat dla tytułów, zdjęcie dla osób.
images	{ [kind]: image }	Najlepszy obraz każdego rodzaju: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Dla każdego rodzaju najlepszy obraz w każdym języku, z kodem języka, rozmiarem i wynikiem.
cast	credit[]	Aktorzy w kolejności z napisów.
crew	credit[]	Wszyscy pozostali twórcy wraz z funkcją.
topBilledIds	number[]	Id osób, które mają być wyróżnione na początku.
seasons	season[]	Sezony w kolejności emisji, każdy ze swoimi odcinkami.
genres	string[]	Slugi gatunków zgodnie z definicją TheTVDB.
languages	string[]	Języki, dla których ten rekord ma pliki.
remoteIds	{ [site]: string }	Id w innych serwisach (imdb, tmdb, wikidata, …), według serwisu.

Przykład

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

Sezony

Pole	Typ	Opis
id	number	Id z TheTVDB.
number	number	Numer sezonu; 0 to odcinki specjalne.
deleted	boolean	True, jeśli rekord został usunięty. Jego pliki pozostają opublikowane.
image	image	Główny obraz: plakat dla tytułów, zdjęcie dla osób.
images	{ [kind]: image }	Najlepszy obraz każdego rodzaju: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Dla każdego rodzaju najlepszy obraz w każdym języku, z kodem języka, rozmiarem i wynikiem.
episodes	episode[]	Odcinki sezonu.

Odcinki

Pole	Typ	Opis
id	number	Id z TheTVDB.
number	number	Numer odcinka w sezonie.
aired	string	Data emisji (YYYY-MM-DD).
runtime	number	Długość w minutach.
image	image	Główny obraz: plakat dla tytułów, zdjęcie dla osób.
criticalToStory	boolean	Oznaczony jako kluczowy dla fabuły.
specialType	string	Rodzaj odcinka specjalnego (odcinki sezonu 0).
deleted	boolean	True, jeśli rekord został usunięty. Jego pliki pozostają opublikowane.

Twórcy

Każdy wpis w cast i crew:

Pole	Typ	Opis
id	number	Id osoby.
activityId	number	Id udziału, unikalne dla każdego udziału.
role	string	Odgrywana postać (obsada).
job	string	Funkcja (ekipa): director, writer, producer, …
slug	string	Slug osoby.
image	image	Zdjęcie osoby.
topBilled	boolean	Wyróżniony udział.
deleted	boolean	True, jeśli osoba została usunięta.

Pliki językowe

Pole	Typ	Opis
type	string	Typ rekordu.
id	number	Id z TheTVDB.
lang	string	Język tego pliku.
name	string	Nazwa w tym języku.
overview	string	Opis w tym języku.
credits	{ [personId]: { name, role } }	Według id osoby: jej imię i nazwisko w tym języku oraz rola.
seasons	{ [seasonId]: { name, overview } }	Według id sezonu: jego nazwa i opis.
episodes	{ [episodeId]: { name, overview } }	Według id odcinka: jego nazwa i opis.

Przykład

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

Wyszukiwanie tytułu po slugu

Adresy URL seriali i filmów używają slugów (breaking-bad). Indeks slugów mapuje każdy slug na jego id i jest podzielony na 256 małych plików: plik danego slugu nosi nazwę od dwóch pierwszych znaków szesnastkowych SHA-1 slugu.

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