영어로 된 FANZA API나 DMM API를 찾아보면 빈손으로 돌아옵니다. 카탈로그는 이 바닥에서 가장 크지만, 정문은 일본 밖에서 잠겨 있고 서류는 전부 일본어입니다. 실제로 무엇이 나와 있는지, 왜 영어로는 하나도 작동하지 않는지, 그리고 같은 메타데이터를 정규화된 JSON으로 받아오는 방법을 짚어봅니다.
FANZA나 DMM에 영어 API가 있는가?
없습니다. affiliate.dmm.com/api에 제휴 API가 있고, FANZA(DMM의 성인 부문)도 같은 것을 씁니다. 다만 일본에 있지 않다면 두 가지 문제 때문에 쓸모가 없습니다:
- 지역 차단됩니다. dmm.co.jp는 지구 대부분을 지역 차단하고, 제휴 API도 같은 벽 뒤에 있습니다. 당신에게 트래픽을 보내주라고 만든 API인데, 그 문서를 읽는 데만도 일본 IP가 필요합니다.
- 문서가 일본어 전용입니다. 영어 레퍼런스는 없습니다. 게다가 응답 스키마는 2014년 DMM 백엔드 생김새 그대로입니다. 필드는 수십 개, 변경 이력도 없고, 하나가 사라져도 알려주지 않습니다.
그러니 “영어 FANZA API”는 설정으로 되는 게 아닙니다. 직접 만들어서 계속 돌봐야 하는 스크레이핑-번역 프로젝트입니다.
DMM/FANZA 메타데이터를 영어로 받아오기
javinfo는 지역 차단 우회와 정규화를 서버에서 한 번에 처리하고, 깔끔한 결과 하나를 건네줍니다. POST /movie로 DVD 코드를 보내고 fanza 프로바이더가 응답하게 하세요:
curl -X POST "https://api.javinfo.dev/movie" \ -H "x-javinfo-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "q": "SSIS-001", "providers": "fanza" }'{ "q": "SSIS-001", "source": "fanza", "result": { "dvdId": "SSIS-001", "titleEn": "Newcomer NO.1 STYLE ...", "titleJa": "新人 NO.1 STYLE ...", "releaseDate": "2020-07-07", "runtimeMins": 120, "makers": ["S1 NO.1 STYLE"], "actresses": ["Example Actress"], "jacketFullUrl": "https://pics.dmm.co.jp/digital/video/ssis00001/ssis00001pl.jpg" }}titleEn과 titleJa가 모두 오므로, 영어는 당신이 직접 번역할 단계가 아니라 그냥 읽어 오는 필드입니다. dmm/fanza 프로바이더는 제목, 출연진, 메이커, 레이블, 시리즈, 커버 아트 같은 이중 언어 메타데이터를 반환하고, 대다수 스크레이퍼가 건너뛰는 배우 프로필 이미지와 샘플 갤러리 URL까지 함께 줍니다. 커버리지는 dmm.co.jp 라이브러리의 약 99%에 이르고, 대부분의 코드는 첫 시도에서 해결됩니다.
단일 매치 대신 목록이 필요하신가요? POST /query는 폭넓은 검색을 받아 같은 형태의 후보 결과를 반환합니다.
하나의 형태, 모든 소스
result 객체는 어느 프로바이더가 응답하든 동일하므로, FANZA용으로 짠 파서가 이미 JavDB, MissAV, javdatabase도 읽습니다. 이것이 전체가 그 위에 세워진 프로바이더에 묶이지 않는 설계입니다. 소스마다 별도 통합을 두는 대신 정규화된 단일 JAV 메타데이터 API 하나만 두는 방식입니다.
app.javinfo.dev에서 가입하고 키를 받아 x-javinfo-key 헤더로 전달하세요(RapidAPI에서도 이용할 수 있습니다). 과금은 사용량 방식입니다. /movie는 성공한 결과당 $0.0005, /query는 $0.0002이며, 실패한 조회는 과금되지 않습니다. 신규 가입 시 1,000회 이상의 무료 조회가 주어지고 신용카드는 필요 없습니다. 이후에는 USDC로 충전하며 1:1로 적립됩니다. 일본 VPN도, 일본어 문서도, 유지보수할 스크레이퍼도 필요 없습니다. 1분 만에 실행할 수 있습니다.