アイドル
統合された出演者カタログを属性で検索するか、1人を ID でルックアップ。
/idols は作品ではなく出演者を検索します。javdatabase と DMM を統合し、毎週再構築する
1つのカタログ。1回のクエリで両方に届きます。
属性で閲覧できます。G カップ、身長、出身地。ID または slug で1人をルックアップ。作品には
/query。/idols は人物検索です。
検索とルックアップ
2つの形：
/idols：スリムなティーザー一覧。GETまたはPOST。/idols/{id}：ID または slug で1人のフルレコード。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"マッチしない一覧は count: 0 と空の results 配列が入った通常の 200。空の /query と
同じく無料です。/idols/{id} だけは例外で、外れると 404。
フィルター
1つ以上を設定。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>。内部キーは出ません。
1人の出演者の形
{
"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
だけ。キャッシュヒットと空結果は無料です。料金を参照。
次へ
- API リファレンス：
/idolsと/idols/{id}、ライブプレイグラウンド付き。 - フィルタリング：
/queryと同じフィルター/ソート文法。