API

De base.json van een film bevat de taalonafhankelijke gegevens en credits; namen en beschrijvingen staan in de taalbestanden.

Bestanden

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

Een afbeelding is een object met de paden full en thumb.

base.json

Veld	Type	Beschrijving
type	string	Recordtype.
id	number	TheTVDB-id.
slug	string	URL-slug, uniek binnen het type.
popularity	number	Populariteitsscore van TheTVDB; hoger is populairder. Scores zijn alleen binnen hetzelfde type vergelijkbaar.
deleted	boolean	True als het record is verwijderd. De bestanden blijven gepubliceerd.
released	string	Releasedatum (YYYY-MM-DD).
runtime	number	Duur in minuten.
image	image	Hoofdafbeelding: een poster voor titels, een foto voor personen.
images	{ [kind]: image }	De beste afbeelding van elk soort: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Per soort de beste afbeelding in elke taal, met taalcode, grootte en score.
cast	credit[]	Acteurs, in volgorde van vermelding.
crew	credit[]	Alle andere vermelde personen, met hun functie.
topBilledIds	number[]	Id's van personen die als eerste worden uitgelicht.
genres	string[]	Genreslugs, zoals TheTVDB ze definieert.
languages	string[]	Talen waarvoor dit record bestanden heeft.
remoteIds	{ [site]: string }	Id's op andere sites (imdb, tmdb, wikidata, …), per site.

Voorbeeld

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

Credits

Elk item in cast en crew:

Veld	Type	Beschrijving
id	number	Id van de persoon.
activityId	number	Credit-id, uniek per credit.
role	string	Gespeeld personage (cast).
job	string	Functie (crew): director, writer, producer, …
slug	string	De slug van de persoon.
image	image	De foto van de persoon.
topBilled	boolean	Een uitgelichte credit.
deleted	boolean	True als de persoon is verwijderd.

Taalbestanden

Veld	Type	Beschrijving
type	string	Recordtype.
id	number	TheTVDB-id.
lang	string	Taal van dit bestand.
name	string	Naam in deze taal.
overview	string	Beschrijving in deze taal.
credits	{ [personId]: { name, role } }	Per persoons-id: de naam in deze taal en de rol.

Voorbeeld

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

Een titel vinden via de slug

Serie- en film-URL's gebruiken slugs (breaking-bad). De slugindex koppelt elke slug aan zijn id en is verdeeld over 256 kleine bestanden: het bestand van een slug is genoemd naar de eerste twee hexadecimale tekens van de SHA-1 van de slug.

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