Watch It? Track It.

API

Все данные Watch It? Track It. публикуются в виде статических JSON-файлов, которые можно скачивать напрямую. Не нужен ни ключ API, ни особый формат запросов: каждая запись лежит в файле по предсказуемому URL.

Все файлы отдаются с адреса:

https://api.watchittrackit.com

Как это устроено

  • У каждой записи есть base.json с данными, не зависящими от языка, и по одному файлу на язык (en.json, de.json, …) с названиями и описаниями.
  • Записи адресуются по типу и id TheTVDB. Страницы сериалов и фильмов используют слаги; индекс слагов превращает слаг в id.
  • Файлы обновляются на месте, когда запись редактируют на сайте или обновляют из TheTVDB (ежедневно). Чтобы дёшево проверить изменения, отправьте If-None-Match с последним ETag файла.
  • Пути к изображениям относительные: добавьте к ним базовый URL. У каждого изображения есть полноразмерная версия и миниатюра.
  • Удалённые записи остаются опубликованными с "deleted": true.
  • Вы можете обращаться к нему откуда угодно, в том числе из браузерного кода на своём сайте: каждый файл отдаётся с заголовком Access-Control-Allow-Origin: *.
curl https://api.watchittrackit.com/v1/tv/81189/base.json
curl https://api.watchittrackit.com/v1/tv/81189/en.json

Лицензирование

Использование данных лицензируется так:

  • Некоммерческие проекты и стартапы: бесплатно.
  • Прибыльные коммерческие проекты, стоимость компании до $1M: $100 в месяц.
  • Прибыльные коммерческие проекты, стоимость компании более $1M: $1,000 в месяц.

Чтобы получить лицензию на коммерческое использование, свяжитесь со Scott Zsori по адресу scott@watchittrackit.com.

Файлы данных