API

O base.json de uma série contém todas as suas temporadas e episódios, então uma única requisição traz a série inteira. Os nomes e descrições da série, das temporadas e dos episódios ficam nos arquivos de idioma.

Arquivos

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 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.
firstAired	string	Data do primeiro episódio (YYYY-MM-DD).
lastAired	string	Data do episódio mais recente.
status	string	Status de exibição do TheTVDB, como Continuing ou Ended.
network	string	Emissora.
originalLanguage	string	Código do idioma original.
originalCountry	string	País de origem (código de três letras).
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.
seasons	season[]	Temporadas na ordem de exibição, cada uma com seus episódios.
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": "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 são os especiais.
deleted	boolean	Verdadeiro se o registro foi removido. Seus arquivos continuam publicados.
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.
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 exibição (YYYY-MM-DD).
runtime	number	Duração em minutos.
image	image	Imagem principal: um pôster para títulos, uma foto 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 registro foi removido. Seus arquivos continuam publicados.

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

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