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