API

O base.json de um filme contém os dados independentes do idioma e os créditos; os nomes e descrições estão nos ficheiros de idioma.

Ficheiros

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

Uma imagem é um objeto com os caminhos full e thumb.

base.json

Campo	Tipo	Descrição
type	string	Tipo de registo.
id	number	Id do TheTVDB.
slug	string	Slug do URL, único dentro do tipo.
popularity	number	Pontuação de popularidade do TheTVDB; quanto mais alta, mais popular. As pontuações só são comparáveis dentro do mesmo tipo.
deleted	boolean	Verdadeiro se o registo foi removido. Os ficheiros continuam publicados.
released	string	Data de estreia (YYYY-MM-DD).
runtime	number	Duração em minutos.
image	image	Imagem principal: um cartaz para títulos, uma fotografia para pessoas.
images	{ [kind]: image }	A melhor imagem de cada tipo: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Para cada tipo, a melhor imagem em cada idioma, com o código do idioma, o tamanho e a pontuação.
cast	credit[]	Atores, pela ordem dos créditos.
crew	credit[]	Todos os restantes creditados, com a respetiva função.
topBilledIds	number[]	Ids das pessoas a destacar primeiro.
genres	string[]	Slugs de género, tal como definidos pelo TheTVDB.
languages	string[]	Idiomas para os quais este registo tem ficheiros.
remoteIds	{ [site]: string }	Ids noutros sites (imdb, tmdb, wikidata, …), indexados pelo site.

Exemplo

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

Créditos

Cada entrada em cast e crew:

Campo	Tipo	Descrição
id	number	Id da pessoa.
activityId	number	Id do crédito, único por crédito.
role	string	Personagem interpretada (elenco).
job	string	Função (equipa): director, writer, producer, …
slug	string	O slug da pessoa.
image	image	A fotografia da pessoa.
topBilled	boolean	Um crédito em destaque.
deleted	boolean	Verdadeiro se a pessoa foi removida.

Ficheiros de idioma

Campo	Tipo	Descrição
type	string	Tipo de registo.
id	number	Id do TheTVDB.
lang	string	Idioma deste ficheiro.
name	string	Nome neste idioma.
overview	string	Descrição neste idioma.
credits	{ [personId]: { name, role } }	Por id de pessoa: o nome neste idioma e o papel.

Exemplo

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

Encontrar um título pelo slug

Os URLs de séries e filmes usam slugs (breaking-bad). O índice de slugs associa cada slug ao respetivo id e está dividido em 256 ficheiros pequenos: o ficheiro de um slug tem como nome os dois primeiros caracteres hexadecimais do SHA-1 do 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())