Fournisseurs

Un fournisseur est une source que javinfo scrape et normalise. Chaque recherche est diffusée vers les fournisseurs enregistrés et renvoie le premier résultat structuré, ainsi un seul appel vous donne les métadonnées, les aimants et les flux sans que vous ayez à maintenir des scrapers qui cassent. Vous pouvez laisser l'API choisir (diffusion) ou épingler la source exacte que vous voulez.

Le répertoire

fanza et dmm sont les deux vitrines DMM + FANZA. Leurs ids de requête sont query:fanza, query:dmm, query:missav, query:javdb, query:javdatabase.

Sélection d'un fournisseur

Par défaut : diffusion

Omettez providers et chaque fournisseur enregistré est un candidat. L'API les essaie dans l'ordre et le premier qui satisfait pleinement votre requête l'emporte :

FANZA → DMM → missav → javdb → javdatabase

Sur /query, un fournisseur qui ne peut pas satisfaire votre filter/sort est ignoré silencieusement et la cascade passe au suivant. Sur /movie et /random, il n'y a pas de filtres, c'est donc simplement le premier résultat qui l'emporte. Le fournisseur qui a répondu est renvoyé dans source :

{ "q": "SSIS-001", "source": "fanza", "result": { "...": "..." } }

Épingler avec providers

Envoyez providers pour forcer une source spécifique (ou un ensemble). Il accepte un tableau ou une liste séparée par des virgules, avec ou sans le préfixe query: :

curl -s -X POST https://api.javinfo.dev/query \
  -H "x-javinfo-key: $KEY" -H 'content-type: application/json' \
  -d '{ "q": "ABP", "providers": ["javdb"], "sort": "rating" }'

"providers": "javdb", ["fanza","missav"] et "query:javdb" sont tous valides. Lorsqu'un fournisseur épinglé ne peut pas satisfaire la requête sur /query, il n'est pas ignoré — l'appel échoue avec 422 et un message nommant la raison (un id inconnu est 400). Consultez Erreurs.

La sélection du fournisseur pilote trois surfaces :

• /query — l'épinglage, la cascade et la capacité par filtre. Quel fournisseur prend en charge quel filter/sort est le cœur du système ; consultez la matrice des capacités complète.
• /movie / /random — pas de filtres ; le gagnant est renvoyé dans source.
• Serveur MCP — les outils javinfo-search / javinfo-movie prennent leur propre argument providers (notez que javdb y est réservé aux vidéos).

Les fournisseurs

fanza / dmm

Les vitrines DMM + FANZA, et la source structurée la plus riche : toutes les dimensions nommées (genre, actress, maker, series, director, label, actor), librement combinées, avec des valeurs de genre/nom en anglais, des filtres de durée en minutes, sort: release et la pagination. Catalogue censuré uniquement — un filtre uncensored les exclut.

missav

La surface de filtrage la plus large et la source de flux (URLs .m3u8). Toutes les dimensions nommées (les genres sont en japonais, p. ex. 巨乳), les plages de durée et de sortie, et censored dans les deux sens. Compromis : pas de tri (pertinence uniquement) et pas de vraie pagination (toujours page 1).

javdb

Pas de filtres par champ, mais le meilleur tri et la source de téléchargement. Uniquement l'onglet censored grossier (dans les deux sens), availability (playable / magnets / subtitle / single) et un sort riche (relevance / release / update / rating). Paginé. Épinglez-le pour les aimants et les liens de téléchargement.

javdatabase

Navigation dans les archives par une seule dimension — genre, actress, maker, series, director — où seuls genre + maker se combinent (une archive genre ∩ studio). Valeurs en anglais, transformées automatiquement en slugs ("S1 NO.1 STYLE" → s1-no-1-style). Censuré et non censuré. Paginé, les plus récents d'abord. Idéal pour les descriptions et les images d'exemple.

Suite

• Filtrage — la matrice complète des capacités par fournisseur et l'aide-mémoire /query.
• Serveur MCP — les fournisseurs comme arguments d'outil.
• Référence de l'API — chaque endpoint avec un playground interactif.