API

En series base.json innehåller alla dess säsonger och avsnitt, så ett enda anrop hämtar hela serien. Namn och beskrivningar för serien, säsongerna och avsnitten finns i språkfilerna.

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

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.
firstAired	string	Datum för första avsnittet (YYYY-MM-DD).
lastAired	string	Datum för det senaste avsnittet.
status	string	Sändningsstatus från TheTVDB, till exempel Continuing eller Ended.
network	string	Kanal.
originalLanguage	string	Kod för originalspråket.
originalCountry	string	Ursprungsland (kod med tre bokstäver).
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.
seasons	season[]	Säsonger i sändningsordning, var och en med sina avsnitt.
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": "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" }
}

Säsonger

Fält	Typ	Beskrivning
id	number	TheTVDB-id.
number	number	Säsongsnummer; 0 är specialavsnitt.
deleted	boolean	Sant om posten har tagits bort. Dess filer förblir publicerade.
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.
episodes	episode[]	Säsongens avsnitt.

Avsnitt

Fält	Typ	Beskrivning
id	number	TheTVDB-id.
number	number	Avsnittsnummer inom säsongen.
aired	string	Sändningsdatum (YYYY-MM-DD).
runtime	number	Längd i minuter.
image	image	Huvudbild: en affisch för titlar, ett foto för personer.
criticalToStory	boolean	Markerat som avgörande för handlingen.
specialType	string	Vilken sorts specialavsnitt det är (avsnitt i säsong 0).
deleted	boolean	Sant om posten har tagits bort. Dess filer förblir publicerade.

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.
seasons	{ [seasonId]: { name, overview } }	Per säsongs-id: namn och beskrivning.
episodes	{ [episodeId]: { name, overview } }	Per avsnitts-id: namn och beskrivning.

Exempel

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

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 = "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())