블로그

작성자 javinfo team

JavLibrary API: 사이트 스크래핑 없이 깊은 카탈로그 조회

JavLibrary에는 공개 API가 없습니다. /movie 또는 /query에 providers: "javlibrary"를 지정하면 제목, 출연진, 표지, 샘플을 받습니다 — 다른 소스가 놓칠 때의 마지막 폴백.

JavLibrary는 고집 센 품번이 마지막으로 숨는 곳입니다. 거대한 카탈로그, 영어 UI, 다른 사이트가 조용히 버리는 릴리스 이력까지. 나오지 않은 건 JavLibrary API뿐입니다. GitHub를 뒤지면 Cloudflare와 싸우며 포스터와 출연진을 긁는 스크래퍼뿐 — 주말 취미로는 괜찮고, 마크업이 바뀌는 새벽 3시에는 지옥입니다.

javinfo는 javlibrary를 진짜 제공자로 돌립니다. 엔드포인트는 다른 소스와 같습니다. 품번을 보내면 JSON이 돌아옵니다.

실제로 받는 것

POST /movieproviders: "javlibrary"를 고정하면 품번 조회입니다: 제목, 출연진, 장르, 러닝타임, 출시일, 스튜디오, 표지, 샘플 이미지, JavLibrary 페이지 URL. 마그넷 없음. HLS 스트림 없음. 카탈로그 데이터이지 다운로드 발판이 아닙니다 — 그게 필요하면 JavDB 또는 MissAV를 쓰세요.

품번 조회
curl -X POST "https://api.javinfo.dev/movie" \
-H "x-javinfo-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "q": "SSIS-001", "providers": "javlibrary" }'
응답 (javlibrary)
{
"q": "SSIS-001",
"source": "javlibrary",
"result": {
"dvdId": "SSIS-001",
"titleEn": "Newcomer NO.1 STYLE ...",
"runtimeMins": 120,
"releaseDate": "2020-07-07",
"makers": ["S1 NO.1 STYLE"],
"categories": ["Beautiful Girl", "Slender"],
"actresses": ["Example Actress"],
"jacketFullUrl": "https://...",
"site": "javlibrary",
"extra": {
"pageUrl": "https://www.javlibrary.com/en/...",
"sampleImages": ["https://..."]
}
}
}

기본 result 형태는 JAV 메타데이터 API의 다른 소스와 같습니다. 파서에 JavLibrary 전용 분기는 필요 없습니다.

왜 맨 뒤에 두는가

이 제공자는 브라우저 스크래프입니다(그 도메인에서 Cloudflare는 선택이 아님). 그래서 우리 소스 중 가장 느립니다. 기본 워터폴은 일부러 맨 끝에 둡니다:

FANZA → DMM → missav → javdb → javdatabase → javlibrary

깊은 카탈로그의 클로저로 생각하면 됩니다 — 빠른 API가 잠수해도 아직 남는 쪽. JavLibrary가 필요하다고 알 때 고정하세요. 속도가 우선이고 폴백만 필요하면 건드리지 마세요.

/query도 동작하지만, 품번과 레이블에 대한 맨몸 키워드 검색뿐입니다. numpage는 존중합니다. 필터와 화려한 정렬은 제외합니다. 전체 절차: JavLibrary 제공자 사용법.

스크래퍼를 직접 쓰지 마세요

JavLibrary 스크래퍼는 부업입니다: Camoufox 또는 FlareSolverr, 연령 게이트 쿠키, 부서지기 쉬운 셀렉터, CF가 심술 부리면 타임아웃 나는 페이지. 그 스택은 이미 서버 측에서 돌리고 있습니다. 여러분은 제공자 비종속 엔드포인트를 하나 호출하고, javdatabase든 누구든 같이 result.*를 읽으면 됩니다.

app.javinfo.dev에서 가입해 키를 받아 x-javinfo-key에 넣으세요(RapidAPI에서도 가능). 사용량 과금: /movie는 성공 1회 $0.0005, /query는 $0.0002, 실패는 무료. 신규 계정은 1,000회 이상 무료 조회, 카드 불필요. 1분이면 라이브 호출까지.