Провайдеры

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

Список провайдеровКопировать ссылку

fanza и dmm — две витрины DMM + FANZA. Id для запросов: query:fanza, query:dmm, query:javdatabase, query:sextb, query:javlibrary, query:javbus, query:missav, query:javdb.

Выбор провайдераКопировать ссылку

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

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

FANZA → DMM → javdatabase → sextb → javlibrary → javbus → missav → javdb

Первые семь, до missav, отдаются из нашего индекса за миллисекунды. javdb загружается вживую и стоит за ними как резерв. /movie меняет последние два местами: javdb чуть впереди missav.

На /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 с причиной (неизвестный id — 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Копировать ссылку

Наш каталог английского сайта. Полная фильтрация: каждое именованное измерение, свободно, плюс оба диапазона, с цензурой и без. Только английские значения, без автослагов; японский q пропускается. Постранично, sort: release работает. Хорош для описаний и изображений.

sextbКопировать ссылку

Потоки из нашего каталога: каждое именованное измерение, оба диапазона, censored в обе стороны. Тайтлы несут URL .m3u8 вместе с обычными метаданными. Постранично, sort: release работает.

javlibraryКопировать ссылку

Глубокий каталог, целиком наш. /movie — поиск по коду: название, состав, жанры, продолжительность, дата выпуска, студия, обложка и примеры изображений (без magnet-ссылок и потоков). /query — полный поиск: каждое именованное измерение, оба диапазона, sort: release, только с цензурой. Постранично. Обращайтесь, когда витрины не находят код.

javbusКопировать ссылку

Наша просканированная копия каталога javbus: около 663 000 тайтлов, с цензурой и без, из нашего индекса без часового лимита. В ней английские и японские названия, состав, жанры, мейкер, лейбл, серия, режиссёр, обложка и галерея.

/query поддерживает каждое именованное измерение, кроме actor, оба диапазона, censored в обе стороны. Значения актрис, мейкера и жанров совпадают на японском или английском (三上悠亜 и Yua Mikami работают оба). Сортировка только relevance или release, результаты постранично. Без availability.

/movie добавляет торренты: каждая magnet-ссылка — запись в result.extra.downloadLinks с именем, info hash, magnet URI, размером в байтах, hd, cnsub, createdAt.

curl -s 'https://api.javinfo.dev/movie?q=BEB-001&providers=javbus' \
  -H "x-javinfo-key: jvi_your_key_here"

{
  "q": "BEB-001",
  "source": "javbus",
  "result": {
    "contentId": null,
    "dvdId": "BEB-001",
    "titleEn": "Hot kiss and embrace JULIA of Bijin Older Sister living in the neighbor",
    "titleJa": "隣に住んでいる美人お姉さんの、熱い接吻と抱擁 JULIA",
    "commentEn": null,
    "commentJa": null,
    "runtimeMins": 118,
    "releaseDate": "2010-12-19",
    "makers": ["Bi"],
    "label": "Bicchi",
    "series": "Hotkissandembraceof○○OlderSisterlivingin",
    "categories": ["Slut", "Threesome / Foursome"],
    "actresses": ["JULIA"],
    "actors": [],
    "directors": ["Sion."],
    "authors": [],
    "jacketFullUrl": "https://www.javbus.com/pics/cover/18gl_b.jpg",
    "jacketThumbUrl": "https://www.javbus.com/pics/thumb/18gl.jpg",
    "site": "javbus",
    "serviceCode": null,
    "extra": {
      "actressesRich": [
        {
          "name": "JULIA",
          "image": "https://www.javbus.com/pics/actress/2de_a.jpg"
        }
      ],
      "sampleUrl": null,
      "galleryFull": [
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001jp-1.jpg",
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001jp-2.jpg"
      ],
      "galleryThumb": [
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001-1.jpg",
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001-2.jpg"
      ],
      "downloadLinks": [
        {
          "name": "BEB-001",
          "hash": "0d640b95d94676448e6faa075b88e701191037d9",
          "magnet": "magnet:?xt=urn:btih:0D640B95D94676448E6FAA075B88E701191037D9&dn=BEB-001",
          "url": null,
          "size": 1642824991,
          "hd": false,
          "cnsub": false,
          "filesCount": null,
          "createdAt": "2026-09-11"
        }
      ],
      "pageUrl": "https://www.javbus.com/en/BEB-001"
    }
  }
}

Массивы обрезаны до одного-двух элементов.

ДалееКопировать ссылку

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