API

קובץ ה-base.json של סרט מכיל את הנתונים שאינם תלויי שפה ואת הקרדיטים; השמות והתיאורים שלו נמצאים בקובצי השפה.

קבצים

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

תמונה היא אובייקט עם הנתיבים full ו-thumb.

base.json

שדה	סוג	תיאור
type	string	סוג הרשומה.
id	number	מזהה TheTVDB.
slug	string	slug לכתובת URL, ייחודי בתוך הסוג.
popularity	number	ציון הפופולריות של TheTVDB; ציון גבוה יותר פירושו פופולרי יותר. אפשר להשוות ציונים רק בתוך אותו סוג.
deleted	boolean	true אם הרשומה הוסרה. הקבצים שלה נשארים מפורסמים.
released	string	תאריך יציאה (YYYY-MM-DD).
runtime	number	אורך בדקות.
image	image	תמונה ראשית: פוסטר ליצירות, תמונה לאנשים.
images	{ [kind]: image }	התמונה הטובה ביותר מכל סוג: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	לכל סוג, התמונה הטובה ביותר בכל שפה, עם קוד השפה, הגודל והציון שלה.
cast	credit[]	שחקנים, לפי סדר הקרדיטים.
crew	credit[]	כל שאר בעלי הקרדיטים, עם התפקיד שלהם.
topBilledIds	number[]	מזהי האנשים שיוצגו ראשונים.
genres	string[]	slug של ז'אנרים, כפי ש-TheTVDB מגדיר אותם.
languages	string[]	השפות שיש לרשומה זו קבצים עבורן.
remoteIds	{ [site]: string }	מזהים באתרים אחרים (imdb, tmdb, wikidata, …), לפי שם האתר.

דוגמה

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

קרדיטים

כל רשומה ב-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 } }	לכל מזהה אדם: השם שלו בשפה זו והתפקיד שלו.

דוגמה

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

מציאת יצירה לפי ה-slug שלה

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