AdultDataLink + javinfo: его аналитические идеи, пересобранные для JAV

AdultDataLink (ADL) больше нет. В октябре автор опубликовал уведомление о закрытии на r/SaaS и выложил код как архивный репозиторий под лицензией MIT. По словам самого автора, API сервиса не работал с конца апреля.

Мы прочитали этот код и пересобрали его лучшие идеи по аналитике и поиску для JAV на собственных данных javinfo. ADL собирал данные примерно с 20 западных tube-сайтов и медиасайтов. javinfo — только JAV, так что это другой продукт; если вашему приложению нужны данные с тех сайтов, здесь их нет. Для этого стоит начать с репозитория ADL.

Если вам нравились аналитика исполнительниц, тренды и рекомендации ADL и вы работаете с JAV, у большинства этих идей теперь есть эндпоинт здесь. 0.7.0 также добавляет /resolve и источник javbus, которые не имеют отношения к ADL. Оба описаны ниже.

Что мы взяли из ADL и где это теперь живёт

Мы прочитали код ADL и реализовали идеи заново на своих данных. Код мы не копировали. Каждая строка ADL в этой таблице взята из публичного репозитория; в правой колонке — то, что выпустили мы.

ADL (`services/engine`)	javinfo
OHLC-свечи исполнительниц в стиле «акций» (`/pornstar-calculation/fetch-pornstar-ohlc-data`)	`GET /analytics/idols/ohlc`
Топ-50 дневных и недельных лидеров роста (`/fetch-top-50-daily-gain`, `/fetch-top-50-weekly-gain`)	`GET /analytics/leaderboard`, `metric=momentum`
Информация об исполнительнице	`GET /analytics/idols/stats` и `/idols`
Тренды по ключевым словам (`/keywords`)	Ближайшее соответствие: `/discover/tags` и `/analytics/market`
Персонализированный поиск (`/machine-learning/search`)	`GET /discover/for-you`

Совпадения — по идее, а не по выдаче. Свечи ADL строились на данных, собранных с tube-сайтов. Наши — на количестве релизов, потому что именно это можно измерить в JAV-каталоге. ADL отслеживал эффективность ключевых слов. Мы считаем движения тегов и жанров за период. ADL строил персонализацию на IP и заголовках посетителя; /discover/for-you использует историю поиска вашего аккаунта.

Не планируем: скрейперы tube-сайтов, скрейпинг-проекты, видеоинструменты, YOLO-разметку и маршруты Reddit.

Поиск

Эндпоинты /discover/* помогают найти тайтлы, когда у вас нет кода.

/discover/trending ранжирует свежие релизы. /discover/underrated возвращает старые тайтлы с высоким рейтингом.
/discover/similar принимает один код и возвращает похожие тайтлы. /discover/suggestion — это автодополнение по кодам, исполнительницам, тегам и студиям.
/discover/for-you выбирает из недавних поисков вашего аккаунта. /discover/duel возвращает пару A/B по seed.
/discover/calendar группирует релизы по дням.
/discover/tags, /studios, /series и /genres — эндпоинты просмотра и подсчёта.
/discover/random и /discover/stats завершают набор.

С календарём есть нюанс. Большие диапазоны возвращаются страницами, содержащими только полные дни. Запросите с 2026-11-01 по 2026-11-14 и получите:

curl "https://api.javinfo.dev/discover/calendar?from=2026-11-01&to=2026-11-14" \
  -H "x-javinfo-key: YOUR_KEY"

{
  "through": "2026-11-05",
  "truncated": true
}

through — последний включённый полный день. Запросите снова с 2026-11-06 и получите остаток. Повторяйте, пока truncated не станет false. Каждая страница — отдельный вызов.

Аналитика исполнительниц

/analytics/* отвечает на вопросы об одной исполнительнице или обо всём рынке.

/analytics/idols/stats: итоги карьеры, топ-жанры и студии, частота релизов.
/analytics/idols/ohlc: свечи по количеству релизов по дням, неделям или месяцам.
/analytics/idols/timeline: месяцы релизов с дебютом, последним релизом, пиком и самым долгим перерывом.
/analytics/idols/costars: исполнительницы, с которыми она снимается чаще всего, с количеством общих тайтлов.
/analytics/leaderboard: исполнительницы, ранжированные по releases, rating или momentum за период.
/analytics/market: растущие и падающие жанры за скользящие недели.

Реальный вызов для Yua Mikami:

curl "https://api.javinfo.dev/analytics/idols/stats?q=yua-mikami" \
  -H "x-javinfo-key: YOUR_KEY"

Он сообщает о 1 127 тайтлах в 8 студиях. Топ-жанр — Big Tits с 765 тайтлами, топ-студия — S1 NO.1 STYLE с 991. works считает каждый тайтл один раз, даже если его перечисляют несколько источников.

Та же исполнительница через /ohlc с bucket=month. Каждая свеча — накопленное число релизов за месяц, а столбики показывают релизы по месяцам. На графике последние три года из 131 месячной свечи, которые возвращает вызов.

Свечной график накопленных релизов Yua Mikami по месяцам за последние три года, итог 1 127 тайтлов

Resolve

Метаданные одного тайтла приходят из многих источников, и они не всегда совпадают. /resolve/* принимает один код и проверяет их все.

GET /resolve возвращает канонический код, его варианты, все источники, где он есть, ссылку на /movie и отрендеренную карточку тайтла в PNG, JPG или SVG.
POST /resolve/batch проверяет до 100 кодов за один вызов и сообщает, какие из них существуют.
GET /resolve/compare ставит два тайтла рядом с оценкой схожести.
GET /resolve/provenance показывает, какой источник что сказал, поле за полем.
GET /resolve/streams сообщает, есть ли у тайтла стрим, сэмпл, трейлер, галерея или магниты.

Для EBOD-391:

curl "https://api.javinfo.dev/resolve?q=EBOD-391&format=jpg" \
  -H "x-javinfo-key: YOUR_KEY"

Код находится в FANZA, javdatabase, javlibrary, javbus и missav. Ответ содержит link: "/movie?q=EBOD-391" для полной записи. Карточка возвращается прямо в ответе и весит около 100 КБ в формате JPG. На ней рейтинг 8.1/10, хронометраж 119 минут, 45 магнитов и отметка, что тайтл доступен для стриминга.

Карточка /resolve для EBOD-391: рейтинг 8,1/10, 119 мин, релиз 2014-08-13, 45 магнитов, доступно для стриминга

Вид по полям существует именно ради происхождения данных. Для одного и того же кода дата выхода — 2014-08-13 в FANZA и 2014-08-09 в javbus. Это обычное расхождение между источниками, и в каталоге такого размера оно встречается. /resolve/provenance возвращает оба значения и оценку уверенности для выбранного, чтобы вы могли решить, чему доверять.

javbus присоединился как источник в этом релизе. Он питает /resolve и происхождение данных, а /discover/random переключается на него при censored=uncensored.

Сколько это стоит

Вы платите только за успешные ответы 200.

Вызов	Цена
`/discover/*`	$0.0004
`/resolve/compare`, `/provenance`, `/streams`	$0.0004
`/resolve` с карточкой тайтла	$0.0012
`/resolve/batch`	$0.0004 за 10 кодов, максимум 100
`/analytics/idols/stats`, `/ohlc`, `/timeline`, `/market`	$0.0006
`/analytics/idols/costars`	$0.0006 до 10 результатов, $0.0009 при значении по умолчанию 15
`/analytics/leaderboard`	$0.0006 до 10 результатов, $0.0012 при значении по умолчанию 20

Базовая цена покрывает до 10 результатов. Эндпоинты-списки дорожают выше этого: 20 результатов стоят вдвое дороже 10, а некоторые значения по умолчанию больше 10 (trending возвращает 20, так что из коробки вызов стоит $0.0008). Попадания в кэш, ошибки и деградированные ответы бесплатны.

Новым аккаунтам начисляют $0.02 бесплатного кредита. Лимит — 10 запросов в минуту до первого пополнения и 60 после любой покупки.

Переход с ADL

Три вещи отличаются от того, к чему вы могли привыкнуть, работая с ADL.

Заголовок авторизации. Передавайте x-javinfo-key, а не x-api-key.
range — это дни. Каждый параметр range означает число дней.
Исполнительницы определяются по id. Эндпоинты аналитики исполнительниц принимают slug javdatabase, например yua-mikami, а не имя. Найдите его через GET /idols?q=, затем передайте id в q. Японское имя, переданное прямо в эндпоинт аналитики, вернёт 404.

Спасибо

Два года строить и тянуть столько почти в одиночку — тяжело, а выложить код вместо того, чтобы дать ему сгнить, — щедро. Спасибо автору ADL за это и за идеи, на которых мы смогли построить своё.

Читайте документацию по поиску, аналитике и resolve, затем зарегистрируйтесь на app.javinfo.dev за ключом.