아이돌
통합 출연자 카탈로그를 속성으로 검색하거나, 한 명을 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"일치 없는 목록은 count: 0과 빈 results 배열의 200. 빈 /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만 청구, 캐시 적중과 빈
결과는 무료. 요금 참조.