API

Die base.json eines Films enthält seine sprachunabhängigen Daten und Mitwirkenden; Namen und Beschreibungen stehen in den Sprachdateien.

Dateien

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

Ein Bild ist ein Objekt mit den Pfaden full und thumb.

base.json

Feld	Typ	Beschreibung
type	string	Datensatztyp.
id	number	TheTVDB-ID.
slug	string	URL-Slug, eindeutig innerhalb des Typs.
popularity	number	Beliebtheitswert von TheTVDB; höher bedeutet beliebter. Werte sind nur innerhalb eines Typs vergleichbar.
deleted	boolean	True, wenn der Datensatz entfernt wurde. Seine Dateien bleiben veröffentlicht.
released	string	Erscheinungsdatum (YYYY-MM-DD).
runtime	number	Länge in Minuten.
image	image	Hauptbild: ein Poster für Titel, ein Foto für Personen.
images	{ [kind]: image }	Das beste Bild jeder Art: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Pro Art das beste Bild in jeder Sprache, mit Sprachcode, Größe und Bewertung.
cast	credit[]	Schauspieler in der Reihenfolge der Nennung.
crew	credit[]	Alle weiteren Mitwirkenden mit ihrer Tätigkeit.
topBilledIds	number[]	IDs der Personen, die zuerst hervorgehoben werden.
genres	string[]	Genre-Slugs, wie TheTVDB sie definiert.
languages	string[]	Sprachen, für die dieser Datensatz Dateien hat.
remoteIds	{ [site]: string }	IDs auf anderen Websites (imdb, tmdb, wikidata, …), nach Website geordnet.

Beispiel

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

Mitwirkende

Jeder Eintrag in cast und crew:

Feld	Typ	Beschreibung
id	number	Personen-ID.
activityId	number	Credit-ID, eindeutig pro Credit.
role	string	Gespielte Rolle (Besetzung).
job	string	Tätigkeit (Crew): director, writer, producer, …
slug	string	Der Slug der Person.
image	image	Das Foto der Person.
topBilled	boolean	Ein hervorgehobener Credit.
deleted	boolean	True, wenn die Person entfernt wurde.

Sprachdateien

Feld	Typ	Beschreibung
type	string	Datensatztyp.
id	number	TheTVDB-ID.
lang	string	Sprache dieser Datei.
name	string	Name in dieser Sprache.
overview	string	Beschreibung in dieser Sprache.
credits	{ [personId]: { name, role } }	Pro Personen-ID: der Name in dieser Sprache und die Rolle.

Beispiel

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

Einen Titel über seinen Slug finden

Serien- und Film-URLs verwenden Slugs (breaking-bad). Der Slug-Index ordnet jedem Slug seine ID zu und ist auf 256 kleine Dateien verteilt: Die Datei eines Slugs ist nach den ersten beiden Hex-Zeichen des SHA-1 des Slugs benannt.

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