С помощью этого API можно использовать наш поисковый движок по базе раздач, получать magnet-ссылки и статистику в удобном JSON-формате.
Все эндпоинты находятся на api.exfreedomist.com
token. Для этого пишите нам на почту mail@freedomist.ru, или в Telegram.
Группы эндпоинтов:
default: редирект на эту страницу и ручка для пинга сервиса /ping;
search: методы, реализующие функционал поиска;
static: получение статичной информации о трекерах и их разделах (досках, boards);
utils: вспомогательные методы для преобразования magnet-ссылок и т.п.
Комментарии к основным эндпоинтам:
/search (swagger | redoc): поиск результатов по текстовому запросу (полностью аналогично поиску в боте). Доступны сортировки, выбор трекеров, фильтрация по размеру и иные модификации поведения поиска. Возвращает список раздач с указанием magnet_key для запроса /magnet.
/search_count (swagger | redoc): возвращает точное количество раздач из базы, подходящих под поисковый запрос.
/infohash (swagger | redoc): поиск раздач по infohash.
/magnet (swagger | redoc): получение magnet-ссылки для скачивания раздачи.
/trackers (swagger | redoc): получение списка трекеров.
/boards (swagger | redoc): возвращает список board_id для конкретного tracker.
/board (swagger | redoc): по указанному board_id возвращает его текстовое описание (это "категория" раздачи).
Github, где можно посмотреть дополнительные доки, которые не вошли почему-то сюда или в сваггер, а также найти реализацию сервера, который использует данное API.
К открытой демо-версии API относятся все запросы без валидного token в параметре или теле запроса. Для получения токенов свяжитесь с нами через почту или Telegram.
Также вы можете получить пробные токены через Telegram-бота @torrents_2_bot: просто напишите ему /trial_token.
⚠️ В связи с участившимися случаями коммерческого использования этого API без какого-либо согласия с нами, усилены ограничения для пользователей без токена.
topic_id будет иметь значение -1;
magnet_key для получения magnet-ссылки из результатов поиска составляет 15 минут;
status_code = 429;
