API

剧集的 base.json 包含其所有季和集，因此一次请求即可获取整部剧集。剧集、季和集的名称与简介位于语言文件中。

文件

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

图片是一个包含 full 和 thumb 路径的对象。

base.json

字段	类型	说明
type	string	记录类型。
id	number	TheTVDB id。
slug	string	URL slug，在同一类型内唯一。
popularity	number	TheTVDB 热度分数，越高越热门。分数仅在同一类型内可比较。
deleted	boolean	如果记录已被删除则为 true。其文件仍保持发布。
firstAired	string	首集播出日期（YYYY-MM-DD）。
lastAired	string	最新一集的播出日期。
status	string	来自 TheTVDB 的播出状态，例如 Continuing or Ended。
network	string	播出平台。
originalLanguage	string	原始语言代码。
originalCountry	string	原始国家（三字母代码）。
image	image	主图：作品为海报，人物为照片。
images	{ [kind]: image }	每种类型中最佳的图片：poster, background, banner, icon, clearart, clearlogo。
imagesByLang	{ [kind]: image[] }	按类型列出每种语言中最佳的图片，附带语言代码、尺寸和分数。
cast	credit[]	演员，按署名顺序排列。
crew	credit[]	其他所有署名人员及其职务。
topBilledIds	number[]	需优先展示的人物 id。
seasons	season[]	按播出顺序排列的季，每季包含其各集。
genres	string[]	类型 slug，按 TheTVDB 的定义。
languages	string[]	此记录拥有文件的语言。
remoteIds	{ [site]: string }	在其他网站（imdb, tmdb, wikidata, …）上的 id，以网站为键。

示例

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

季

字段	类型	说明
id	number	TheTVDB id。
number	number	季号；0 表示特别篇。
deleted	boolean	如果记录已被删除则为 true。其文件仍保持发布。
image	image	主图：作品为海报，人物为照片。
images	{ [kind]: image }	每种类型中最佳的图片：poster, background, banner, icon, clearart, clearlogo。
imagesByLang	{ [kind]: image[] }	按类型列出每种语言中最佳的图片，附带语言代码、尺寸和分数。
episodes	episode[]	该季的各集。

集

字段	类型	说明
id	number	TheTVDB id。
number	number	在所属季中的集号。
aired	string	播出日期（YYYY-MM-DD）。
runtime	number	时长（分钟）。
image	image	主图：作品为海报，人物为照片。
criticalToStory	boolean	标记为对剧情至关重要。
specialType	string	特别篇的类型（第 0 季的集）。
deleted	boolean	如果记录已被删除则为 true。其文件仍保持发布。

演职人员

cast 和 crew 中的每一项：

字段	类型	说明
id	number	人物 id。
activityId	number	职员表条目 id，每个条目唯一。
role	string	饰演的角色（演员）。
job	string	职务（职员）：director, writer, producer, …
slug	string	该人物的 slug。
image	image	该人物的照片。
topBilled	boolean	重点展示的条目。
deleted	boolean	如果该人物已被删除则为 true。

语言文件

字段	类型	说明
type	string	记录类型。
id	number	TheTVDB id。
lang	string	此文件的语言。
name	string	此语言下的名称。
overview	string	此语言下的简介。
credits	{ [personId]: { name, role } }	按人物 id：其在此语言下的名称和角色。
seasons	{ [seasonId]: { name, overview } }	按季 id：名称和简介。
episodes	{ [episodeId]: { name, overview } }	按集 id：名称和简介。

示例

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

通过 slug 查找作品

剧集和电影的 URL 使用 slug（breaking-bad）。slug 索引将每个 slug 映射到其 id，并拆分为 256 个小文件：slug 所在文件以该 slug 的 SHA-1 值的前两个十六进制字符命名。

// 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())