Watch It? Track It.

API

Alles auf Watch It? Track It. wird als statische JSON-Dateien veröffentlicht, die du direkt herunterladen kannst. Es gibt keinen API-Schlüssel und kein Anfrageformat zu lernen: Jeder Datensatz ist eine Datei unter einer vorhersehbaren URL.

Alle Dateien werden bereitgestellt unter:

https://api.watchittrackit.com

So funktioniert es

  • Jeder Datensatz hat eine base.json mit seinen sprachunabhängigen Daten und eine Datei pro Sprache (en.json, de.json, …) mit seinen Namen und Beschreibungen.
  • Datensätze werden über Typ und TheTVDB-ID adressiert. Serien- und Filmseiten verwenden Slugs; der Slug-Index wandelt einen Slug in eine ID um.
  • Dateien ändern sich direkt, wenn ein Datensatz auf der Website bearbeitet oder von TheTVDB aktualisiert wird (täglich). Sende If-None-Match mit dem letzten ETag einer Datei, um günstig auf Änderungen zu prüfen.
  • Bildpfade sind relativ: Stelle ihnen die Basis-URL voran. Jedes Bild gibt es in voller Größe und als Vorschaubild.
  • Entfernte Datensätze bleiben mit "deleted": true veröffentlicht.
  • Du kannst sie von überall aufrufen, auch aus Browser-Code auf deiner eigenen Website: Jede Datei wird mit Access-Control-Allow-Origin: * ausgeliefert.
curl https://api.watchittrackit.com/v1/tv/81189/base.json
curl https://api.watchittrackit.com/v1/tv/81189/en.json

Lizenzierung

Die Nutzung der Daten ist wie folgt lizenziert:

  • Nichtkommerzielle Projekte und Startups: kostenlos.
  • Profitable kommerzielle Projekte, Unternehmenswert bis 1 Mio. $: 100 $ pro Monat.
  • Profitable kommerzielle Projekte, Unternehmenswert über 1 Mio. $: 1.000 $ pro Monat.

Für eine Lizenz zur kommerziellen Nutzung wende dich an Scott Zsori unter scott@watchittrackit.com.

Datendateien