Comment utiliser le fournisseur JavLibrary : recherches /movie et /query nu

Le fournisseur javlibrary est le fallback catalogue profond : top quand un code manque partout ailleurs, mauvais choix si tu l’épingles sur chaque requête et que tu te demandes pourquoi tout est lent. Voici comment l’appeler sans deviner.

Quand y aller

Utilise javlibrary quand :

Un code renvoie 404 sur FANZA/DMM, missav, javdb et javdatabase
Tu veux l’URL de page JavLibrary + les images d’échantillon pour un DVD ID connu
Tu fais une recherche mot-clé nue et les fournisseurs plus rapides ne renvoient rien d’utile

Ne l’épingles pas comme ta source par défaut « toujours essayer en premier ». Scraping navigateur = latence plus haute. Laisse-le en dernier dans le fan-out sauf raison précise.

Contexte sur le pourquoi de son existence : API JavLibrary.

1. Récupère une clé

Inscris-toi sur app.javinfo.dev. Mets la clé dans x-javinfo-key. La même clé marche sur RapidAPI via leurs headers si tu préfères ce chemin.

2. Fiche complète : `POST /movie`

Code exact, ligne normalisée complète :

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

Tu obtiens titre, casting, genres (categories), durée, date de sortie, studio (makers / label), jaquette (jacketFullUrl), plus extra.pageUrl et extra.sampleImages. source sera "javlibrary".

Pas de magnets. Pas de flux .m3u8. Si tu en as besoin, épingle javdb ou missav à la place — même forme de métadonnées, extras différents.

3. Recherche liste : `POST /query`

Recherche mot-clé sur codes et labels. Garde-la nue :

curl -X POST "https://api.javinfo.dev/query" \
  -H "x-javinfo-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "q": "SSIS", "providers": "javlibrary", "num": 10, "page": 1 }'

Ce qui marche :

q — fragment de code ou mot-clé style label
num — taille de page (défaut 10, max 50). Les lignes sont coupées à num avant l’enrichissement de jaquette
page — base 1 ; javlibrary sert de grosses pages de liste et on slice à num

Ce qui écarte javlibrary en silence (ou bruyamment) :

N’importe quel filter (genre, actrice, plage de durée, censored, …)
N’importe quel sort autre que relevance (ou le défaut)

En mode fan-out ces params sautent javlibrary et testent le prochain fournisseur capable. Si tu épingles "providers": "javlibrary" avec un filtre qu’il ne peut pas satisfaire, tu reçois un 422 avec une raison — pas une devinette partielle.

Les hits de query ressemblent à :

{
  "q": "SSIS",
  "source": "javlibrary",
  "count": 10,
  "results": [
    {
      "id": "javmezzbqu",
      "dvdId": "SSIS-001",
      "title": "Newcomer NO.1 STYLE ...",
      "cover": "https://...",
      "releaseDate": "2020-07-07",
      "extra": { "url": "https://www.javlibrary.com/en/..." }
    }
  ]
}

Jaquettes et dates de sortie sont re-remplies depuis l’index DMM/FANZA quand on peut matcher le code. Les miniatures de liste sont le fallback.

Fan-out vs pin

Ordre par défaut (le premier hit complet gagne) :

FANZA → DMM → missav → javdb → javdatabase → javlibrary

Omets providers et javlibrary ne répond que quand tout le monde devant rate ou ne peut pas satisfaire la requête. Épingle-le quand tu veux cette source même si une plus rapide marcherait aussi.

Erreurs qui brûlent un appel

Attendre des liens de téléchargement. Mauvais fournisseur. Utilise javdb.

Envoyer filter.genre en épinglant javlibrary. 422. Drop le filtre ou épingle une source qui le supporte (fanza/dmm, missav, javdatabase).

L’utiliser pour la vitesse. Il est en dernier pour une raison. Le cache aide sur les codes répétés (cacheTtl d’une heure côté serveur), mais le premier scrape reste un job navigateur.

Traiter /query comme un explorateur d’archives complet. C’est de la pertinence mot-clé, pas des archives genre ∩ studio. Pour du browsing style archive, javdatabase est plus proche.

Prix + étape suivante

/movie réussi = 0,0005 $. /query réussi = 0,0002 $. Misses et erreurs non facturés. Nouvelles inscriptions : 1 000+ recherches offertes.

Prends une clé, lance le curl ci-dessus, puis branche le même body dans ton app. Une intégration indépendante du fournisseur — JavLibrary n’est qu’un autre id dans providers.