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.
slug	string	slug לכתובת URL, ייחודי בתוך הסוג.
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[]	מזהי האנשים שיוצגו ראשונים.
seasons	season[]	עונות לפי סדר השידור, כל אחת עם הפרקים שלה.
genres	string[]	slug של ז'אנרים, כפי ש-TheTVDB מגדיר אותם.
languages	string[]	השפות שיש לרשומה זו קבצים עבורן.
remoteIds	{ [site]: string }	מזהים באתרים אחרים (imdb, tmdb, wikidata, …), לפי שם האתר.

דוגמה

{
  "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.
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.
number	number	מספר הפרק בתוך העונה.
aired	string	תאריך שידור (YYYY-MM-DD).
runtime	number	אורך בדקות.
image	image	תמונה ראשית: פוסטר ליצירות, תמונה לאנשים.
criticalToStory	boolean	מסומן כחיוני לעלילה.
specialType	string	סוג הפרק המיוחד (פרקים של עונה 0).
deleted	boolean	true אם הרשומה הוסרה. הקבצים שלה נשארים מפורסמים.

קרדיטים

כל רשומה ב-cast וב-crew:

שדה	סוג	תיאור
id	number	מזהה האדם.
activityId	number	מזהה הקרדיט, ייחודי לכל קרדיט.
role	string	הדמות שגולמה (שחקנים).
job	string	תפקיד (צוות): director, writer, producer, …
slug	string	ה-slug של האדם.
image	image	התמונה של האדם.
topBilled	boolean	קרדיט מוצג בבולטות.
deleted	boolean	true אם האדם הוסר.

קובצי שפה

שדה	סוג	תיאור
type	string	סוג הרשומה.
id	number	מזהה TheTVDB.
lang	string	שפת הקובץ הזה.
name	string	השם בשפה זו.
overview	string	התיאור בשפה זו.
credits	{ [personId]: { name, role } }	לכל מזהה אדם: השם שלו בשפה זו והתפקיד שלו.
seasons	{ [seasonId]: { name, overview } }	לכל מזהה עונה: השם והתיאור שלה.
episodes	{ [episodeId]: { name, overview } }	לכל מזהה פרק: השם והתיאור שלו.

דוגמה

{
  "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 למזהה שלו, ומחולק ל-256 קבצים קטנים: שם הקובץ של slug הוא שני התווים ההקסדצימליים הראשונים של ה-SHA-1 של ה-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())