Идолы

/idols ищет исполнителей, а не тайтлы. Один каталог объединяет javdatabase и DMM и пересобирается каждую неделю: один запрос охватывает оба источника.

Просматривайте по атрибуту — чашка G, рост, место рождения — или находите одного по id или slug. Тайтлы: /query. /idols — это поиск по людям.

Поиск и просмотрКопировать ссылку

Две формы:

• /idols: короткие тизеры. GET или POST.
• /idols/{id}: один исполнитель с полной записью, по id или slug. Только 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"

Список без совпадений — обычный 200 с count: 0 и пустым results. Бесплатен, как любой пустой /query. Исключение — /idols/{id}: промах даёт 404.

ФильтрыКопировать ссылку

Задайте один или несколько. Без q и без фильтра: 400.

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

Сортировка и страницыКопировать ссылку

sort — relevance (по умолчанию), name, age, debut или height. debut сортирует по дате рождения, сначала новейшие: ближайшее возможное, каталог не сортирует по дате дебюта.

num — 1–50 (по умолчанию 10), page — с 1. Как в /query.

Как выглядит элемент спискаКопировать ссылку

/idols возвращает короткий тизер на каждое совпадение — ровно то, что рисует карточка. Полная запись: /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://…"
    }
  ]
}

Передайте id в /idols/{id}. Это slug javdatabase или dmm-<n> для исполнителей, которых знает только DMM. Внутренний ключ не показывается.

Как выглядит один исполнительКопировать ссылку

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

Каждое поле — по мере возможности; неизвестные значения остаются null. age вычисляется из dob при запросе, поэтому актуален после пересборки.

СтоимостьКопировать ссылку

$0.50 за 1000 вызовов при num=10, растёт с размером страницы. Списывается только свежий 200; кэш и пустые результаты бесплатны. См. тарификацию.

ДалееКопировать ссылку

• Справочник API: /idols и /idols/{id} с живой песочницей.
• Фильтрация: та же грамматика фильтров и сортировки в /query.