API

Il base.json di una serie contiene tutte le sue stagioni e i suoi episodi, quindi una sola richiesta restituisce l'intera serie. Nomi e descrizioni della serie, delle stagioni e degli episodi si trovano nei file di lingua.

File

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

Un'immagine è un oggetto con i percorsi full e thumb.

base.json

Campo	Tipo	Descrizione
type	string	Tipo di record.
id	number	Id TheTVDB.
slug	string	Slug dell'URL, univoco all'interno del tipo.
popularity	number	Punteggio di popolarità di TheTVDB; più è alto, più è popolare. I punteggi sono confrontabili solo all'interno dello stesso tipo.
deleted	boolean	True se il record è stato rimosso. I suoi file restano pubblicati.
firstAired	string	Data del primo episodio (YYYY-MM-DD).
lastAired	string	Data dell'episodio più recente.
status	string	Stato di messa in onda secondo TheTVDB, come Continuing o Ended.
network	string	Rete.
originalLanguage	string	Codice della lingua originale.
originalCountry	string	Paese d'origine (codice di tre lettere).
image	image	Immagine principale: un poster per i titoli, una foto per le persone.
images	{ [kind]: image }	L'immagine migliore di ogni tipo: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Per ogni tipo, l'immagine migliore in ogni lingua, con codice lingua, dimensioni e punteggio.
cast	credit[]	Attori, in ordine di apparizione nei crediti.
crew	credit[]	Tutte le altre persone accreditate, con il loro ruolo.
topBilledIds	number[]	Id delle persone da mettere in evidenza per prime.
seasons	season[]	Stagioni in ordine di messa in onda, ciascuna con i suoi episodi.
genres	string[]	Slug dei generi, come definiti da TheTVDB.
languages	string[]	Lingue per cui questo record ha dei file.
remoteIds	{ [site]: string }	Id su altri siti (imdb, tmdb, wikidata, …), indicizzati per sito.

Esempio

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

Stagioni

Campo	Tipo	Descrizione
id	number	Id TheTVDB.
number	number	Numero della stagione; 0 indica gli speciali.
deleted	boolean	True se il record è stato rimosso. I suoi file restano pubblicati.
image	image	Immagine principale: un poster per i titoli, una foto per le persone.
images	{ [kind]: image }	L'immagine migliore di ogni tipo: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Per ogni tipo, l'immagine migliore in ogni lingua, con codice lingua, dimensioni e punteggio.
episodes	episode[]	Gli episodi della stagione.

Episodi

Campo	Tipo	Descrizione
id	number	Id TheTVDB.
number	number	Numero dell'episodio all'interno della stagione.
aired	string	Data di messa in onda (YYYY-MM-DD).
runtime	number	Durata in minuti.
image	image	Immagine principale: un poster per i titoli, una foto per le persone.
criticalToStory	boolean	Segnato come essenziale per la trama.
specialType	string	Che tipo di speciale è (episodi della stagione 0).
deleted	boolean	True se il record è stato rimosso. I suoi file restano pubblicati.

Crediti

Ogni voce in cast e crew:

Campo	Tipo	Descrizione
id	number	Id della persona.
activityId	number	Id del credito, univoco per ogni credito.
role	string	Personaggio interpretato (cast).
job	string	Ruolo (troupe): director, writer, producer, …
slug	string	Lo slug della persona.
image	image	La foto della persona.
topBilled	boolean	Un credito in evidenza.
deleted	boolean	True se la persona è stata rimossa.

File di lingua

Campo	Tipo	Descrizione
type	string	Tipo di record.
id	number	Id TheTVDB.
lang	string	Lingua di questo file.
name	string	Nome in questa lingua.
overview	string	Descrizione in questa lingua.
credits	{ [personId]: { name, role } }	Per id della persona: il suo nome in questa lingua e il suo ruolo.
seasons	{ [seasonId]: { name, overview } }	Per id della stagione: nome e descrizione.
episodes	{ [episodeId]: { name, overview } }	Per id dell'episodio: nome e descrizione.

Esempio

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

Trovare un titolo tramite il suo slug

Gli URL di serie e film usano gli slug (breaking-bad). L'indice degli slug associa ogni slug al suo id ed è suddiviso in 256 piccoli file: il file di uno slug prende il nome dai primi due caratteri esadecimali dello SHA-1 dello slug.

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