API

Sarjan base.json sisältää kaikki sen tuotantokaudet ja jaksot, joten yhdellä pyynnöllä saa koko sarjan. Sarjan, tuotantokausien ja jaksojen nimet ja kuvaukset ovat kielitiedostoissa.

Tiedostot

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

Kuva on objekti, jossa on polut full ja thumb.

base.json

Kenttä	Tyyppi	Kuvaus
type	string	Tietueen tyyppi.
id	number	TheTVDB-tunniste.
slug	string	URL-slug, yksilöllinen tyypin sisällä.
popularity	number	TheTVDB:n suosiopisteet; suurempi arvo tarkoittaa suositumpaa. Pisteet ovat vertailukelpoisia vain saman tyypin sisällä.
deleted	boolean	Tosi, jos tietue on poistettu. Sen tiedostot pysyvät julkaistuina.
firstAired	string	Ensimmäisen jakson päivämäärä (YYYY-MM-DD).
lastAired	string	Viimeisimmän jakson päivämäärä.
status	string	TheTVDB:n esitystila, esimerkiksi Continuing tai Ended.
network	string	Kanava.
originalLanguage	string	Alkuperäiskielen koodi.
originalCountry	string	Alkuperämaa (kolmikirjaiminen koodi).
image	image	Pääkuva: juliste nimikkeille, valokuva henkilöille.
images	{ [kind]: image }	Paras kuva kustakin lajista: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Kustakin lajista paras kuva kullakin kielellä, kielikoodin, koon ja pisteiden kera.
cast	credit[]	Näyttelijät tekijäluettelon järjestyksessä.
crew	credit[]	Kaikki muut tekijät tehtävineen.
topBilledIds	number[]	Ensimmäisinä nostettavien henkilöiden tunnisteet.
seasons	season[]	Tuotantokaudet esitysjärjestyksessä, kukin jaksoineen.
genres	string[]	Lajityyppien slugit TheTVDB:n määritelmien mukaisesti.
languages	string[]	Kielet, joille tietueella on tiedostot.
remoteIds	{ [site]: string }	Tunnisteet muilla sivustoilla (imdb, tmdb, wikidata, …), avaimena sivusto.

Esimerkki

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

Tuotantokaudet

Kenttä	Tyyppi	Kuvaus
id	number	TheTVDB-tunniste.
number	number	Tuotantokauden numero; 0 on erikoisjaksot.
deleted	boolean	Tosi, jos tietue on poistettu. Sen tiedostot pysyvät julkaistuina.
image	image	Pääkuva: juliste nimikkeille, valokuva henkilöille.
images	{ [kind]: image }	Paras kuva kustakin lajista: poster, background, banner, icon, clearart, clearlogo.
imagesByLang	{ [kind]: image[] }	Kustakin lajista paras kuva kullakin kielellä, kielikoodin, koon ja pisteiden kera.
episodes	episode[]	Tuotantokauden jaksot.

Jaksot

Kenttä	Tyyppi	Kuvaus
id	number	TheTVDB-tunniste.
number	number	Jakson numero tuotantokauden sisällä.
aired	string	Esityspäivä (YYYY-MM-DD).
runtime	number	Kesto minuutteina.
image	image	Pääkuva: juliste nimikkeille, valokuva henkilöille.
criticalToStory	boolean	Merkitty juonen kannalta olennaiseksi.
specialType	string	Minkä tyyppinen erikoisjakso on kyseessä (kauden 0 jaksot).
deleted	boolean	Tosi, jos tietue on poistettu. Sen tiedostot pysyvät julkaistuina.

Tekijät

Jokainen cast- ja crew-luettelon merkintä:

Kenttä	Tyyppi	Kuvaus
id	number	Henkilön tunniste.
activityId	number	Tekijämerkinnän tunniste, yksilöllinen merkintää kohden.
role	string	Esitetty hahmo (näyttelijät).
job	string	Tehtävä (työryhmä): director, writer, producer, …
slug	string	Henkilön slug.
image	image	Henkilön valokuva.
topBilled	boolean	Nostettu tekijämerkintä.
deleted	boolean	Tosi, jos henkilö on poistettu.

Kielitiedostot

Kenttä	Tyyppi	Kuvaus
type	string	Tietueen tyyppi.
id	number	TheTVDB-tunniste.
lang	string	Tämän tiedoston kieli.
name	string	Nimi tällä kielellä.
overview	string	Kuvaus tällä kielellä.
credits	{ [personId]: { name, role } }	Henkilötunnisteittain: henkilön nimi tällä kielellä ja rooli.
seasons	{ [seasonId]: { name, overview } }	Tuotantokauden tunnisteittain: nimi ja kuvaus.
episodes	{ [episodeId]: { name, overview } }	Jakson tunnisteittain: nimi ja kuvaus.

Esimerkki

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

Nimikkeen löytäminen slugin perusteella

Sarjojen ja elokuvien URL-osoitteet käyttävät slugeja (breaking-bad). Slug-hakemisto yhdistää jokaisen slugin sen tunnisteeseen, ja se on jaettu 256 pieneen tiedostoon: slugin tiedosto on nimetty slugin SHA-1-tiivisteen kahden ensimmäisen heksadesimaalimerkin mukaan.

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