API метаданных JAV: один эндпоинт вместо пяти скраперов

Если вам нужны метаданные JAV в вашем приложении, вот путь, по которому проходят все. Вы находите источник, пишете скрапер, скрапер ломается, вы пишете ещё один для второго источника, чтобы закрыть пробелы, и через полгода вы поддерживаете пять хрупких интеграций просто чтобы получить название, дату выхода и обложку.

Публичного, стабильного API метаданных JAV не существует. И никогда не существовало. javinfo — это он. В этом вся причина его существования.

Почему «API метаданных JAV» так трудно найти

Данные реальны и хорошо структурированы. Проблема в доступе. Каждый источник, к которому вы бы обратились, — это сайт с защитами, а не API с контрактом:

DMM / FANZA держит большую часть каталога и геоблокирует почти всю планету. Есть партнёрский API, но документация только на японском и сидит за тем же блоком.
JavDB не имеет вообще никакого официального API, только общественные скраперы, носящие это имя, большинству из которых нужен FlareSolverr, чтобы пройти Cloudflare.
JavBus, JavLibrary, R18 — та же история: самостоятельно размещаемые скраперы и Docker-контейнеры, парсеры, привязанные к HTML, который меняется без уведомления.

Так что «API», который вы находите на GitHub, всегда оказывается скрапером, а скрапер наследует каждую проблему исходного сайта. Переименование класса ломает ваш парсер без журнала изменений и без предупреждения. Проверки Cloudflare и региональные блокировки означают, что вы вдобавок запускаете обход через headless-браузер и прокси. А поскольку каждый источник возвращает свой формат, закрытие пробелов означает, что вы сами нормализуете три-четыре схемы.

Вы поддерживаете не одну интеграцию. Вы поддерживаете скрапер, обход, прокси и пейджер на 2 часа ночи.

Что вместо этого делает javinfo

Один эндпоинт. Отправьте код — получите один нормализованный результат, тот же формат полей, независимо от того, какой источник ответил.

curl -X POST "https://api.javinfo.dev/movie" \
  -H "x-javinfo-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "q": "SSIS-001" }'

{
  "q": "SSIS-001",
  "source": "r18",
  "result": {
    "dvdId": "SSIS-001",
    "titleEn": "Newcomer NO.1 STYLE ...",
    "releaseDate": "2020-07-07",
    "runtimeMins": 120,
    "makers": ["S1 NO.1 STYLE"],
    "actresses": ["Example Actress"],
    "jacketFullUrl": "https://pics.dmm.co.jp/digital/video/ssis00001/ssis00001pl.jpg"
  }
}

Каждый провайдер укладывается в один и тот же базовый формат result: dvdId, titleEn/titleJa, releaseDate, runtimeMins, makers, label, series, actresses, jacketFullUrl и другие. Вы читаете result.* одинаково по всем источникам. Мы берём на себя скрапинг, схватки с Cloudflare и обходы геоблоков, чтобы вы этого не делали. Это дизайн без привязки к источнику, на котором построено всё остальное. Для широких запросов эндпоинт /query возвращает список совпадений вместо одного лучшего.

Провайдеры

Дайте javinfo выбрать первое совпадение или закрепите источник через providers:

r18 возвращает двуязычные метаданные (название, состав, производитель, лейбл, серия, обложки), а также изображения профилей актрис и URL сэмплов/галереи.
javdb добавляет массив extra.downloadLinks со ссылками magnet и на скачивание — то, за что борются скраперы.
missav добавляет extra.pageUrl (ссылка на страницу) и extra.streams с master-плейлистом HLS (.m3u8) и вариантами по разрешению.
javdatabase добавляет описание, сэмпл-изображения и трейлер.
javlibrary скоро появится.

При промахе, или если все источники вышли по таймауту, вы получаете 404, что обычно просто означает, что код не проиндексирован. Ответы кешируются на стороне сервера, так что повторные запросы быстрые.

Начало

Зарегистрируйтесь на app.javinfo.dev, получите ключ и передавайте его в заголовке x-javinfo-key (также доступно на RapidAPI). Все провайдеры возвращают полные данные на каждом запросе, без гейтинга — тарификация по потреблению: /movie стоит $0,001 за успешный результат, /query стоит $0,0002, неудачные запросы не тарифицируются. Пополнение в USDC, зачисляется 1:1, а при пополнении от $50 начисляется случайный бонус 5–50%; новым пользователям при регистрации даётся 1000+ бесплатных запросов для старта, без банковской карты. Никакого Docker, никакого FlareSolverr, никакого японского VPN, никаких cookie для обновления. Начать можно за минуту.