Proveedores

Un proveedor es una fuente que javinfo scrapea y normaliza. Cada búsqueda se distribuye entre los proveedores registrados y devuelve el primer resultado estructurado, así que una sola llamada te da metadatos, imanes y streams sin que tengas que mantener scrapers que se rompen. Puedes dejar que la API elija (distribución) o fijar la fuente exacta que quieras.

El elenco

fanza y dmm son las dos tiendas DMM + FANZA. Sus ids de consulta son query:fanza, query:dmm, query:missav, query:javdb, query:javdatabase.

Selección de un proveedor

Predeterminado: distribución

Omite providers y todos los proveedores registrados son candidatos. La API los prueba en orden y gana el primero que satisface completamente tu solicitud:

FANZA → DMM → missav → javdb → javdatabase

En /query, un proveedor que no puede satisfacer tu filter/sort se omite silenciosamente y la cascada avanza al siguiente. En /movie y /random no hay filtros, así que simplemente gana el primer resultado. El proveedor que respondió se devuelve como source:

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

Fijar con providers

Envía providers para forzar una fuente específica (o conjunto). Acepta un array o una lista separada por comas, con o sin el prefijo 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"] y "query:javdb" son todos válidos. Cuando un proveedor fijado no puede satisfacer la solicitud en /query, no se omite — la llamada falla con 422 y un message que indica el motivo (un id desconocido es 400). Consulta Errores.

La selección de proveedores gobierna tres superficies:

• /query — fijado, la cascada y la capacidad por filtro. Qué proveedor admite qué filter/sort es el núcleo del sistema; consulta la matriz de capacidades completa.
• /movie / /random — sin filtros; el ganador se devuelve como source.
• Servidor MCP — las herramientas javinfo-search / javinfo-movie toman su propio argumento providers (ten en cuenta que ahí javdb es solo para películas).

Los proveedores

fanza / dmm

Las tiendas DMM + FANZA, y la fuente estructurada más completa: todas las dimensiones con nombre (genre, actress, maker, series, director, label, actor), combinadas libremente, con valores de género/nombre en inglés, filtros de duración por minutos, sort: release y paginación. Solo catálogo censurado — un filtro uncensored los excluye.

missav

La mayor superficie de filtros y la fuente de streams (URLs .m3u8). Todas las dimensiones con nombre (los géneros están en japonés, p. ej. 巨乳), rangos de duración y de lanzamiento, y censored en ambos sentidos. Contrapartida: sin ordenación (solo relevancia) y sin paginación real (siempre página 1).

javdb

Sin filtros por campo, pero la mejor ordenación y la fuente de descargas. Solo la pestaña general de censored (ambos sentidos), availability (playable / magnets / subtitle / single) y sort avanzado (relevance / release / update / rating). Paginado. Fíjalo para imanes y enlaces de descarga.

javdatabase

Exploración de archivo por una única dimensión — genre, actress, maker, series, director — donde solo se combinan genre + maker (un archivo género ∩ estudio). Valores en inglés, convertidos automáticamente en slug ("S1 NO.1 STYLE" → s1-no-1-style). Censurado y sin censura. Paginado, más reciente primero. Bueno para descripciones e imágenes de muestra.

Siguiente

• Filtrado — la matriz de capacidades completa por proveedor y la guía rápida de /query.
• Servidor MCP — los proveedores como argumentos de herramienta.
• Referencia de la API — cada endpoint con un playground interactivo.