API

Il base.json di un film contiene i dati indipendenti dalla lingua e i crediti; nomi e descrizioni si trovano nei file di lingua.

File

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

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.
released	string	Data di uscita (YYYY-MM-DD).
runtime	number	Durata in minuti.
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.
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": "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" }
}

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.

Esempio

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

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