演员
按属性搜索合并后的演员目录，或按 id 查找单个演员。
/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。
| 筛选条件 | 类型 | 含义 |
|---|---|---|
source | "javdatabase" | "dmm" | 列在哪个来源 |
tag | 字符串 | 自由格式标签 |
cup | 字符串 | 罩杯，例如 "G" |
blood | 字符串 | 血型 |
sign | 字符串 | 星座 |
birthplace | 字符串 | 出生地 |
hairColor | 字符串 | 发色 |
hairLength | 字符串 | 发长 |
ageMin / ageMax | 数字 | 年龄范围 |
heightMin / heightMax | 数字 | 身高范围，单位 cm |
# 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}。它是 javdatabase 的 slug；只有 DMM 知道的演员则为
dmm-<n>。内部键从不出现。
单个演员长什么样
{
"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 计算，目录重建后仍保持
最新。
费用
num=10 时每 1,000 次调用 $0.50，随页大小上涨。只有全新的 200 收费；缓存命中和空结果
免费。见计费。