Idoles

/idols cherche des interprètes, pas des titres. Un catalogue fusionné depuis javdatabase et DMM, reconstruit chaque semaine : une requête atteint les deux sources.

Parcours par attribut — bonnet G, taille, lieu de naissance — ou consulte une interprète par id ou slug. Titres : /query. /idols est la recherche de personnes.

Recherche et consultationCopier le lien

Deux formes :

• /idols : aperçus courts. GET ou POST.
• /idols/{id} : une interprète avec la fiche complète, par id ou slug. GET uniquement.

# 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"

Une liste sans correspondance est un 200 normal, avec count: 0 et results vide. Gratuit, comme toute recherche /query vide. /idols/{id} fait exception : un échec renvoie 404.

FiltresCopier le lien

Définis-en un ou plusieurs. Sans q ni filtre : 400.

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

Tri et paginationCopier le lien

sort est relevance (par défaut), name, age, debut ou height. debut trie par date de naissance, la plus récente d'abord : le plus proche possible, le catalogue ne triant pas sur la date de début.

num va de 1 à 50 (par défaut 10) et page commence à 1. Comme sur /query.

À quoi ressemble un élément de la listeCopier le lien

/idols renvoie un aperçu court par correspondance, juste ce qu'affiche une carte. Fiche complète : /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://…"
    }
  ]
}

Transmets l'id à /idols/{id}. C'est un slug javdatabase, ou dmm-<n> pour les interprètes que seul DMM connaît. La clé interne n'apparaît jamais.

À quoi ressemble un interprèteCopier le lien

{
  "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 }
  }
}

Chaque champ est fourni au mieux ; les valeurs inconnues restent null. age est calculé depuis dob à la requête, donc à jour après chaque reconstruction.

CoûtCopier le lien

$0.50 pour 1 000 appels avec num=10, et le prix augmente avec la taille de page. Seul un 200 frais est facturé ; cache et résultats vides sont gratuits. Voir facturation.

SuiteCopier le lien

• Référence de l'API : /idols et /idols/{id} avec un playground interactif.
• Filtrage : la même grammaire filtre/tri sur /query.