Провайдеры

Провайдер — это источник, который javinfo парсит и нормализует. Каждый поиск веерно расходится по зарегистрированным провайдерам и возвращает первый структурированный результат, так что один вызов даёт вам метаданные, magnet-ссылки и потоки без необходимости поддерживать парсеры, которые ломаются. Вы можете позволить API выбрать самому (веерный запрос) или закрепить конкретный источник, который вам нужен.

Список провайдеров

fanza и dmm — это две витрины DMM + FANZA. Их идентификаторы для запросов — query:fanza, query:dmm, query:missav, query:javdb, query:javdatabase, query:javlibrary.

Выбор провайдера

По умолчанию: веерный запрос

Не указывайте providers — и кандидатом становится каждый зарегистрированный провайдер. API пробует их по порядку, и побеждает первый, который полностью удовлетворяет ваш запрос:

FANZA → DMM → missav → javdb → javdatabase → javlibrary

javlibrary парсится через браузер, поэтому он самый медленный и стоит последним в каскадах как /movie, так и /query — финальный резервный вариант, когда провайдеры API не находят результат.

На /query провайдер, который не может удовлетворить ваш filter/sort, молча пропускается, и каскад переходит к следующему. На /movie и /random фильтров нет, поэтому побеждает просто первое совпадение. Провайдер, который ответил, возвращается в поле source:

{ "q": "SSIS-001", "source": "fanza", "result": { "...": "..." } }

Закрепление через providers

Отправьте providers, чтобы принудительно выбрать конкретный источник (или набор). Он принимает массив или список через запятую, с префиксом query: или без него:

curl -s -X POST https://api.javinfo.dev/query \
  -H "x-javinfo-key: $KEY" -H 'content-type: application/json' \
  -d '{ "q": "ABP", "providers": ["javdb"], "sort": "rating" }'

"providers": "javdb", ["fanza","missav"] и "query:javdb" — все допустимы. Когда закреплённый провайдер не может удовлетворить запрос на /query, он не пропускается — вызов завершается ошибкой 422 с полем message, указывающим причину (неизвестный идентификатор даёт 400). См. Ошибки.

Выбор провайдера влияет на три области:

• /query — закрепление, каскад и возможности по каждому фильтру. То, какой провайдер поддерживает какой filter/sort, — это суть всей системы; см. полную матрицу возможностей.
• /movie / /random — без фильтров; победитель возвращается в поле source.
• MCP-сервер — инструменты javinfo-search / javinfo-movie принимают собственный аргумент providers (обратите внимание, что javdb там доступен только для фильмов).

Провайдеры

fanza / dmm

Витрины DMM + FANZA и самый богатый структурированный источник: все именованные измерения (genre, actress, maker, series, director, label, actor), свободно комбинируются, с английскими значениями жанров/имён, фильтрами продолжительности в минутах, sort: release и разбивкой на страницы. Только каталог с цензурой — фильтр uncensored их исключает.

missav

Самый широкий набор фильтров и источник потоков (URL-адреса .m3u8). Каждое именованное измерение (жанры японские, например 巨乳), диапазоны как продолжительности, так и дат выпуска, и censored в обе стороны. Компромисс: без сортировки (только релевантность) и без настоящей разбивки на страницы (всегда страница 1).

javdb

Без фильтров по полям, но лучшая сортировка и источник для скачивания. Только грубая вкладка censored (в обе стороны), availability (playable / magnets / subtitle / single) и богатая sort (relevance / release / update / rating). С разбивкой на страницы. Закрепляйте его ради magnet-ссылок и ссылок для скачивания.

javdatabase

Просмотр архива по одному измерению — genre, actress, maker, series, director — где комбинируются только genre + maker (архив жанр ∩ студия). Английские значения, автоматически преобразуются в слаги ("S1 NO.1 STYLE" → s1-no-1-style). С цензурой и без цензуры. С разбивкой на страницы, сначала новейшие. Хорош для описаний и примеров изображений.

javlibrary

Резервный источник глубокого каталога, парсится через браузер, поэтому он самый медленный и работает последним в обоих каскадах. На /movie это поиск по коду, возвращающий название, актёрский состав, жанры, продолжительность, дату выпуска, студию, обложку и примеры изображений (без magnet-ссылок и потоков). На /query это поиск по ключевым словам среди кодов и лейблов: он учитывает num, но не имеет фильтров и сортировки (только релевантность), а обложки и даты выпуска подставляются из каталога DMM + FANZA. Обращайтесь к нему, когда каждый провайдер API не находит код.

Далее

• Фильтрация — полная матрица возможностей по каждому провайдеру и шпаргалка по /query.
• MCP-сервер — провайдеры как аргументы инструментов.
• Справочник API — каждая конечная точка с интерактивной песочницей.