API

O base.json de um filme contém seus dados independentes de idioma e os créditos; os nomes e descrições ficam nos arquivos de idioma.

Arquivos

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 do registro.
id	number	Id do TheTVDB.
slug	string	Slug da URL, único dentro do tipo.
popularity	number	Pontuação de popularidade do TheTVDB; quanto maior, mais popular. As pontuações só são comparáveis dentro do mesmo tipo.
deleted	boolean	Verdadeiro se o registro foi removido. Seus arquivos continuam publicados.
released	string	Data de lançamento (YYYY-MM-DD).
runtime	number	Duração em minutos.
image	image	Imagem principal: um pôster para títulos, uma foto 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, na ordem dos créditos.
crew	credit[]	Todos os demais creditados, com sua função.
topBilledIds	number[]	Ids das pessoas a destacar primeiro.
genres	string[]	Slugs de gênero, conforme definidos pelo TheTVDB.
languages	string[]	Idiomas para os quais este registro tem arquivos.
remoteIds	{ [site]: string }	Ids em outros 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 item 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 interpretado (elenco).
job	string	Função (equipe): director, writer, producer, …
slug	string	O slug da pessoa.
image	image	A foto da pessoa.
topBilled	boolean	Um crédito em destaque.
deleted	boolean	Verdadeiro se a pessoa foi removida.

Arquivos de idioma

Campo	Tipo	Descrição
type	string	Tipo do registro.
id	number	Id do TheTVDB.
lang	string	Idioma deste arquivo.
name	string	Nome neste idioma.
overview	string	Descrição neste idioma.
credits	{ [personId]: { name, role } }	Por id de pessoa: o nome dela neste idioma e seu 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" } }
}

Como encontrar um título pelo slug

As URLs de séries e filmes usam slugs (breaking-bad). O índice de slugs associa cada slug ao seu id e é dividido em 256 arquivos pequenos: o arquivo de um slug é nomeado pelos 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())