Idols

/idols busca intérpretes, no títulos. Un catálogo fusionado de javdatabase y DMM, reconstruido cada semana: una consulta alcanza ambas fuentes.

Explora por atributo — copa G, altura, lugar de nacimiento — o busca una por id o slug. Títulos: /query. /idols es la búsqueda de personas.

Búsqueda y consultaCopiar enlace

Dos formas:

• /idols: avances breves. GET o POST.
• /idols/{id}: un intérprete con el registro completo, por id o slug. Solo GET.

# A list of matches
curl -s -X POST https://api.javinfo.dev/idols \
  -H "x-javinfo-key: $KEY" -H 'content-type: application/json' \
  -d '{ "q": "yui", "num": 20 }'

# One performer
curl -s https://api.javinfo.dev/idols/dmm-1005467 \
  -H "x-javinfo-key: $KEY"

Una lista sin coincidencias es un 200 normal con count: 0 y results vacío. Gratis, como todo /query vacío. /idols/{id} es la excepción: un fallo es 404.

FiltrosCopiar enlace

Configura uno o más. Sin q ni filtro: 400.

# Every G-cup performer, tallest first
-d '{ "filter": { "cup": "G" }, "sort": "height" }'

Ordenación y paginaciónCopiar enlace

sort es relevance (predeterminado), name, age, debut o height. debut ordena por fecha de nacimiento, más reciente primero: lo más cerca que llega el catálogo, que no ordena por fecha de debut.

num va de 1 a 50 (predeterminado 10) y page empieza en 1. Igual que en /query.

Cómo se ve un elemento de la listaCopiar enlace

/idols devuelve un avance breve por coincidencia, justo lo que muestra una tarjeta. Registro completo: /idols/{id}.

{
  "q": "yui",
  "source": "idols",
  "count": 10,
  "total": 42,          // estimated matches across all pages (may be capped)
  "results": [
    {
      "id": "dmm-1005467",
      "name": "…",
      "nameJa": "…",
      "image": "https://…",
      "tags": ["…"],
      "pageUrl": "https://…"
    }
  ]
}

Pasa el id a /idols/{id}. Es un slug de javdatabase, o dmm-<n> para intérpretes que solo conoce DMM. La clave interna nunca aparece.

Cómo se ve un intérpreteCopiar enlace

{
  "q": "dmm-1005467",
  "source": "idols",
  "result": {
    "id": "dmm-1005467",
    "name": "…",
    "nameJa": "…",
    "image": "https://…",
    "tags": ["…"],
    "pageUrl": "https://…",
    "slug": "…",
    "age": 37,
    "dob": "1990-01-01",
    "debut": "…",
    "debutAge": 20,
    "birthplace": "…",
    "sign": "…",
    "blood": "…",
    "measurements": "…",
    "cup": "…",
    "heightCm": 165,
    "shoeSize": 24.5,
    "hairLengths": ["…"],
    "hairColors": ["…"],
    "aliases": ["…"],
    "images": ["https://…"],
    "sources": ["javdatabase", "dmm"],
    "ids": { "javdatabase": "…", "dmm": 1005467 }
  }
}

Cada campo es de mejor esfuerzo; los valores desconocidos quedan en null. age se calcula desde dob en la petición, así que sigue al día tras cada reconstrucción.

CostoCopiar enlace

$0.50 por cada 1000 llamadas con num=10, y escala con el tamaño de página. Solo se cobra un 200 nuevo; caché y resultados vacíos son gratis. Consulta facturación.

SiguienteCopiar enlace

• Referencia de la API: /idols e /idols/{id} con playground en vivo.
• Filtrado: la misma gramática de filtro/orden en /query.