С помощью этого API можно использовать наш поисковый движок по базе раздач, получать magnet-ссылки и статистику в удобном JSON-формате.
Все эндпоинты находятся на домене api.exfreedomist.com
mail@exfreedomist.com, или в личку Telegram
сразу с указанием желаемого количества запросов.
Вы можете получить пробные токены на 10 запросов через Telegram-бота @torrents_2_bot:
для этого напишите ему /trial_token.
Группы эндпоинтов:
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, где можно посмотреть реализацию сервера на FastAPI (Python), который использует данное API.
