API

En films base.json innehåller dess språkoberoende data och medverkande; namn och beskrivningar finns i språkfilerna.

Filer

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

En bild är ett objekt med sökvägarna full och thumb.

base.json

Fält	Typ	Beskrivning
type	string	Posttyp.
id	number	TheTVDB-id.
slug	string	URL-slug, unik inom typen.
popularity	number	Popularitetspoäng från TheTVDB; högre betyder populärare. Poängen är bara jämförbara inom samma typ.
deleted	boolean	Sant om posten har tagits bort. Dess filer förblir publicerade.
released	string	Premiärdatum (YYYY-MM-DD).
runtime	number	Längd i minuter.
image	image	Huvudbild: en affisch för titlar, ett foto för personer.
images	{ [kind]: image }	Den bästa bilden av varje sort: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	För varje sort, den bästa bilden på varje språk, med språkkod, storlek och poäng.
cast	credit[]	Skådespelare, i den ordning de krediteras.
crew	credit[]	Alla andra som krediteras, med sin uppgift.
topBilledIds	number[]	Id:n för personer som ska visas först.
genres	string[]	Genre-slugs, så som TheTVDB definierar dem.
languages	string[]	Språk som posten har filer för.
remoteIds	{ [site]: string }	Id:n på andra webbplatser (imdb, tmdb, wikidata, …), med webbplatsen som nyckel.

Exempel

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

Medverkande

Varje post i cast och crew:

Fält	Typ	Beskrivning
id	number	Personens id.
activityId	number	Id för medverkan, unikt per medverkan.
role	string	Rollfigur (skådespelare).
job	string	Uppgift (filmteam): director, writer, producer, …
slug	string	Personens slug.
image	image	Personens foto.
topBilled	boolean	En framhävd medverkan.
deleted	boolean	Sant om personen har tagits bort.

Språkfiler

Fält	Typ	Beskrivning
type	string	Posttyp.
id	number	TheTVDB-id.
lang	string	Filens språk.
name	string	Namn på detta språk.
overview	string	Beskrivning på detta språk.
credits	{ [personId]: { name, role } }	Per person-id: personens namn på detta språk och rollen.

Exempel

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

Hitta en titel via dess slug

URL:er för serier och filmer använder slugs (breaking-bad). Slug-indexet kopplar varje slug till dess id och är uppdelat i 256 små filer: en slugs fil namnges efter de två första hexadecimala tecknen i slugens 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())