API

O base.json de uma série contém todas as temporadas e episódios, por isso um único pedido obtém a série inteira. Os nomes e descrições da série, das temporadas e dos episódios estão nos ficheiros de idioma.

Ficheiros

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

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.
firstAired	string	Data do primeiro episódio (YYYY-MM-DD).
lastAired	string	Data do episódio mais recente.
status	string	Estado de emissão do TheTVDB, como Continuing ou Ended.
network	string	Canal.
originalLanguage	string	Código do idioma original.
originalCountry	string	País de origem (código de três letras).
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.
seasons	season[]	Temporadas pela ordem de emissão, cada uma com os seus episódios.
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": "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" }
}

Temporadas

Campo	Tipo	Descrição
id	number	Id do TheTVDB.
number	number	Número da temporada; 0 corresponde aos especiais.
deleted	boolean	Verdadeiro se o registo foi removido. Os ficheiros continuam publicados.
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.
episodes	episode[]	Os episódios da temporada.

Episódios

Campo	Tipo	Descrição
id	number	Id do TheTVDB.
number	number	Número do episódio dentro da temporada.
aired	string	Data de emissão (YYYY-MM-DD).
runtime	number	Duração em minutos.
image	image	Imagem principal: um cartaz para títulos, uma fotografia para pessoas.
criticalToStory	boolean	Marcado como essencial para a história.
specialType	string	Que tipo de especial é (episódios da temporada 0).
deleted	boolean	Verdadeiro se o registo foi removido. Os ficheiros continuam publicados.

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.
seasons	{ [seasonId]: { name, overview } }	Por id de temporada: nome e descrição.
episodes	{ [episodeId]: { name, overview } }	Por id de episódio: nome e descrição.

Exemplo

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

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