API

En series base.json inneholder alle sesongene og episodene, så én forespørsel henter hele serien. Navn og beskrivelser for serien, sesongene og episodene ligger i språkfilene.

Filer

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

Et bilde er et objekt med stiene full og thumb.

base.json

Felt	Type	Beskrivelse
type	string	Posttype.
id	number	TheTVDB-id.
slug	string	URL-slug, unik innenfor typen.
popularity	number	Popularitetspoeng fra TheTVDB; høyere betyr mer populær. Poengene kan bare sammenlignes innenfor samme type.
deleted	boolean	Sann hvis posten er fjernet. Filene forblir publisert.
firstAired	string	Dato for første episode (YYYY-MM-DD).
lastAired	string	Dato for siste episode.
status	string	Sendestatus fra TheTVDB, for eksempel Continuing eller Ended.
network	string	Kanal.
originalLanguage	string	Kode for originalspråket.
originalCountry	string	Opprinnelsesland (kode på tre bokstaver).
image	image	Hovedbilde: en plakat for titler, et foto for personer.
images	{ [kind]: image }	Det beste bildet av hver sort: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	For hver sort, det beste bildet på hvert språk, med språkkode, størrelse og poeng.
cast	credit[]	Skuespillere, i krediteringsrekkefølge.
crew	credit[]	Alle andre som er kreditert, med oppgaven sin.
topBilledIds	number[]	Id-er for personer som skal fremheves først.
seasons	season[]	Sesonger i sendingsrekkefølge, hver med sine episoder.
genres	string[]	Sjanger-slugs, slik TheTVDB definerer dem.
languages	string[]	Språk posten har filer for.
remoteIds	{ [site]: string }	Id-er på andre nettsteder (imdb, tmdb, wikidata, …), med nettstedet som nøkkel.

Eksempel

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

Sesonger

Felt	Type	Beskrivelse
id	number	TheTVDB-id.
number	number	Sesongnummer; 0 er spesialepisoder.
deleted	boolean	Sann hvis posten er fjernet. Filene forblir publisert.
image	image	Hovedbilde: en plakat for titler, et foto for personer.
images	{ [kind]: image }	Det beste bildet av hver sort: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	For hver sort, det beste bildet på hvert språk, med språkkode, størrelse og poeng.
episodes	episode[]	Episodene i sesongen.

Episoder

Felt	Type	Beskrivelse
id	number	TheTVDB-id.
number	number	Episodenummer innenfor sesongen.
aired	string	Sendedato (YYYY-MM-DD).
runtime	number	Lengde i minutter.
image	image	Hovedbilde: en plakat for titler, et foto for personer.
criticalToStory	boolean	Merket som viktig for handlingen.
specialType	string	Hva slags spesialepisode det er (episoder i sesong 0).
deleted	boolean	Sann hvis posten er fjernet. Filene forblir publisert.

Medvirkende

Hver oppføring i cast og crew:

Felt	Type	Beskrivelse
id	number	Personens id.
activityId	number	Id for kreditten, unik per kreditt.
role	string	Rollefigur (skuespillere).
job	string	Oppgave (stab): director, writer, producer, …
slug	string	Personens slug.
image	image	Personens foto.
topBilled	boolean	En fremhevet kreditt.
deleted	boolean	Sann hvis personen er fjernet.

Språkfiler

Felt	Type	Beskrivelse
type	string	Posttype.
id	number	TheTVDB-id.
lang	string	Språket til denne filen.
name	string	Navn på dette språket.
overview	string	Beskrivelse på dette språket.
credits	{ [personId]: { name, role } }	Per person-id: navnet på dette språket og rollen.
seasons	{ [seasonId]: { name, overview } }	Per sesong-id: navn og beskrivelse.
episodes	{ [episodeId]: { name, overview } }	Per episode-id: navn og beskrivelse.

Eksempel

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

Finne en tittel via slug

URL-er for serier og filmer bruker slugs (breaking-bad). Slug-indeksen kobler hver slug til id-en sin og er delt opp i 256 små filer: filen for en slug er oppkalt etter de to første heksadesimale tegnene i SHA-1 av slugen.

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