API для разработчиков приложений

С помощью этого API можно использовать наш поисковый движок по базе раздач, получать magnet-ссылки и статистику в удобном JSON-формате.

Все эндпоинты находятся на домене api.exfreedomist.com

Документация: Swagger | ReDoc

Краткое описание

Группы эндпоинтов:

• 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 возвращает его текстовое описание (это "категория" раздачи).

Ключи сортировки выдачи

• d = sort by downloads (desc) | по убыванию скачиваний (по информации из оригинального источника)
• z = sort by size (desc) | по убыванию размера раздачи
• r = sort by size (asc) | по возрастанию размера раздачи
• t = sort by last update date (desc) | по дате от новых к старым
• s = sort by seeders (desc) | по убыванию сидеров (раздающих)
• l = sort by lexicographical order by title | в лексикографическом порядке
• i = sort by tracker name (lex asc) | по названию трекера (также в лексикографическом)

Токены

⚠️ Почти для всех методов вам потребуются специальные токены доступа, которые регулируют нагрузку и легитимность использования нашего API. Для тестирования и разработки вы можете использовать демо-токены (на 100 запросов), которые выдаёт @torrents_2_bot: просто напишите ему /trial_token.

Для получения полноценных токенов для промышленного использования отправьте заявку на mail@exfreedomist.com с указанием цели использования и названием сервиса (если он есть в публичном доступе).

Примеры использования

Репозиторий на Github, где можно посмотреть реализацию сервера на FastAPI (Python), который использует данное API.