AdultDataLink + javinfo : ses idées d'analytics, reconstruites pour le JAV

AdultDataLink (ADL) n’existe plus. En octobre, l’auteur a publié un avis de fermeture sur r/SaaS et rendu le code public sous forme de dépôt archivé, sous licence MIT. D’après l’auteur lui-même, l’API hébergée était hors ligne depuis fin avril.

On a lu ce code et reconstruit ses meilleures idées d’analytics et de découverte pour le JAV, sur les données de javinfo. ADL scrapait une vingtaine de tubes et sites média occidentaux. javinfo ne fait que du JAV : c’est donc un autre produit, et si ton app a besoin des données de ces sites, tu ne les trouveras pas ici. Le dépôt ADL est le bon point de départ pour ça.

Si tu appréciais les analytics d’interprètes, les tendances et les recommandations d’ADL et que tu travailles avec le JAV, la plupart de ces idées ont désormais un endpoint ici. La 0.7.0 ajoute aussi /resolve et une source javbus, sans rapport avec ADL. Les deux sont détaillés ci-dessous.

Ce qu’on a repris d’ADL, et où ça vit maintenant

On a lu le code d’ADL et réimplémenté les idées sur nos données. On n’a pas copié de code. Chaque ligne ADL de ce tableau vient de son dépôt public ; la colonne de droite correspond à ce que nous avons livré.

Les correspondances se font sur l’idée, pas sur le résultat. Les bougies d’ADL venaient de données scrapées sur des tubes. Les nôtres sont construites à partir du nombre de sorties, parce que c’est ce qu’un catalogue JAV peut mesurer. ADL suivait la performance des mots-clés. Les nôtres comptent les tags et les mouvements de genres sur une fenêtre de temps. ADL fondait la personnalisation sur l’IP et les en-têtes du visiteur ; /discover/for-you utilise l’historique de recherche de ton propre compte.

Pas prévu : les scrapers de tubes, les projets de scraping, les outils vidéo, l’annotation YOLO et les routes Reddit.

Découverte

Les endpoints /discover/* t’aident à trouver des titres quand tu n’as pas de code.

• /discover/trending classe les sorties récentes. /discover/underrated renvoie des titres plus anciens bien notés.
• /discover/similar prend un code et renvoie des titres similaires. /discover/suggestion fait de l’autocomplétion sur les codes, interprètes, tags et studios.
• /discover/for-you pioche dans les recherches récentes de ton compte. /discover/duel renvoie une paire A/B tirée à partir d’une graine.
• /discover/calendar regroupe les sorties par jour.
• /discover/tags, /studios, /series et /genres sont les endpoints de navigation et de comptage.
• /discover/random et /discover/stats complètent le tout.

Le calendrier a une particularité. Les grandes fenêtres reviennent en pages de journées complètes. Demande du 2026-11-01 au 2026-11-14 et tu obtiens :

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 est le dernier jour complet inclus. Redemande à partir du 2026-11-06 et tu obtiens le reste. Répète jusqu’à ce que truncated soit false. Chaque page est un appel séparé.

Analytics d’interprètes

Les endpoints /analytics/* répondent aux questions sur une interprète ou sur tout le marché.

• /analytics/idols/stats : totaux de carrière, genres et studios principaux, rythme de sorties.
• /analytics/idols/ohlc : bougies du nombre de sorties par jour, semaine ou mois.
• /analytics/idols/timeline : mois de sortie avec débuts, dernière sortie, pic et plus long intervalle.
• /analytics/idols/costars : les interprètes avec lesquels une idole travaille le plus, avec le nombre de titres en commun.
• /analytics/leaderboard : les idoles classées par releases, rating ou momentum sur une fenêtre.
• /analytics/market : les genres en hausse et en baisse sur des semaines glissantes.

Un appel réel, pour Yua Mikami :

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

Il rapporte 1 127 titres répartis sur 8 studios. Le genre principal est Big Tits avec 765 titres, et le studio principal S1 NO.1 STYLE avec 991. works compte chaque titre une seule fois, même quand plusieurs sources le listent.

La même interprète via /ohlc avec bucket=month. Chaque bougie est le nombre cumulé de sorties à la fin du mois, et les barres montrent les sorties de chaque mois. Le graphique montre les trois dernières années des 131 bougies mensuelles que renvoie l’appel.

Resolve

Les métadonnées d’un titre viennent de nombreuses sources, qui ne sont pas toujours d’accord. /resolve/* prend un code et les vérifie toutes.

• GET /resolve renvoie le code canonique, ses variantes, toutes les sources qui le possèdent, un lien vers /movie, et une carte de titre rendue en PNG, JPG ou SVG.
• POST /resolve/batch vérifie jusqu’à 100 codes en un appel et t’indique lesquels existent.
• GET /resolve/compare met deux titres côte à côte avec un score de similarité.
• GET /resolve/provenance montre quelle source a dit quoi, champ par champ.
• GET /resolve/streams indique si un titre a un flux, un échantillon, une bande-annonce, une galerie ou des magnets.

Pour EBOD-391 :

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

Le code est trouvé dans FANZA, javdatabase, javlibrary, javbus et missav. La réponse inclut link: "/movie?q=EBOD-391" pour la fiche complète. La carte est renvoyée directement et pèse environ 100 KB en JPG. Elle affiche une note de 8.1/10, une durée de 119 minutes, 45 magnets, et indique que le titre peut être lu en streaming.

C’est la provenance qui justifie la vue champ par champ. Pour le même code, la date de sortie est 2014-08-13 sur FANZA et 2014-08-09 sur javbus. C’est un désaccord net entre sources, et ça arrive sur un catalogue de cette taille. /resolve/provenance renvoie les deux valeurs et un score de confiance pour celle qu’il a retenue, pour que tu puisses décider à quoi te fier.

javbus rejoint les sources dans cette version. Il alimente /resolve et la provenance, et /discover/random passe par lui quand tu demandes censored=uncensored.

Combien ça coûte

Tu n’es facturé que pour les réponses 200 réussies.

Le prix de base couvre jusqu’à 10 résultats. Le tarif des endpoints de liste augmente au-delà : 20 résultats coûtent deux fois plus que 10, et plusieurs valeurs par défaut dépassent 10 (trending renvoie 20, donc il coûte $0.0008 dès le départ). Les hits de cache, les erreurs et les réponses dégradées sont gratuits.

Les nouveaux comptes reçoivent $0.02 de crédit gratuit. La limite est de 10 requêtes par minute jusqu’à ta première recharge, et 60 après tout achat.

Migrer depuis ADL

Trois choses diffèrent de ce que tu as peut-être écrit pour ADL.

• En-tête d’auth. Envoie x-javinfo-key, pas x-api-key.
• range est en jours. Chaque paramètre range désigne un nombre de jours.
• Les idoles sont identifiées par id. Les endpoints d’analytics d’idoles prennent un slug javdatabase comme yua-mikami, pas un nom. Trouve-le avec GET /idols?q=, puis passe l’id en q. Un nom japonais envoyé directement à un endpoint d’analytics renvoie 404.

Merci

Construire et faire tourner autant de choses en solo pendant deux ans, c’est dur, et publier le code au lieu de le laisser pourrir, c’est généreux. Merci à l’auteur d’ADL pour ça, et pour les idées sur lesquelles on a pu construire.

Lis la doc pour la découverte, les analytics et resolve, puis inscris-toi sur app.javinfo.dev pour obtenir une clé.