Блог

Автор javinfo team

FANZA / DMM API на английском: как получить метаданные

Единственный API FANZA -- партнёрская лента только на японском, а dmm.co.jp геоблокирует весь мир. Вот как получить нормализованные метаданные DMM/FANZA на английском по коду.

Ищете FANZA API или DMM API на английском – и возвращаетесь ни с чем. Каталог тут самый большой из всех, но парадная дверь заперта для всех, кто вне Японии, а все бумаги на японском. Разберём, что вообще существует, почему ничего из этого не работает на английском и как получить те же метаданные в виде нормализованного JSON.

Есть ли у FANZA или DMM API на английском?

Нет. Есть партнёрский API по адресу affiliate.dmm.com/api, и FANZA (взрослое подразделение DMM) работает на нём же. Две проблемы делают его бесполезным, если вы не в Японии:

Так что «FANZA API на английском» – это не то, что настраивается. Это проект по скрейпингу и переводу, который придётся сначала собрать, а потом нянчить.

Как получить метаданные DMM/FANZA на английском

javinfo один раз проходит обход геоблока и нормализацию на сервере и отдаёт вам один чистый результат. Отправьте DVD-код на POST /movie и дайте ответить провайдеру fanza:

Look up a FANZA/DMM code
curl -X POST "https://api.javinfo.dev/movie" \
-H "x-javinfo-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "q": "SSIS-001", "providers": "fanza" }'
Response (fanza)
{
"q": "SSIS-001",
"source": "fanza",
"result": {
"dvdId": "SSIS-001",
"titleEn": "Newcomer NO.1 STYLE ...",
"titleJa": "新人 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"
}
}

Вы получаете сразу titleEn и titleJa, так что английский – это поле, которое вы читаете, а не шаг перевода, который лежит на вас. Провайдер dmm/fanza возвращает двуязычные метаданные – название, состав, студию, лейбл, серию, обложку – плюс фото из профилей актрис и URL галерей с образцами, которые большинство скрейперов пропускают. Покрытие – примерно 99% библиотеки dmm.co.jp, и большинство кодов находятся с первой попытки.

Нужен список, а не одно совпадение? POST /query принимает широкий поиск и возвращает кандидатов в той же форме.

Одна форма, любой источник

Объект result одинаков независимо от того, какой провайдер ответил, так что парсер, который вы написали под FANZA, уже читает JavDB, MissAV и javdatabase. Это независимый от провайдера дизайн, на котором всё построено – один нормализованный API метаданных JAV вместо отдельной интеграции под каждый источник.

Зарегистрируйтесь на app.javinfo.dev, получите ключ и передавайте его в заголовке x-javinfo-key (также на RapidAPI). Оплата по факту использования: /movie – $0.0005 за успешный результат, /query – $0.0002, а неудачные запросы не тарифицируются. Новым пользователям – 1000+ бесплатных запросов без кредитной карты; дальше пополняете в USDC, зачисление 1:1. Ни японского VPN, ни японской документации, ни скрейпера на поддержке. Запуститься можно за минуту.