JavLibrary 제공자 사용법: /movie 조회와 맨몸 /query

javlibrary는 깊은 카탈로그 폴백입니다: 품번이 다른 어디에 없을 때 강하고, 매 요청에 고정해 두고 느리다고 놀라면 잘못 쓰는 겁니다. 추측 없이 호출하는 방법입니다.

언제 쓰나

javlibrary를 쓰세요:

FANZA/DMM, missav, javdb, javdatabase에서 품번이 전부 404일 때
알려진 DVD ID의 JavLibrary 페이지 URL + 샘플 이미지가 필요할 때
맨몸 키워드 검색인데 빠른 제공자가 쓸모 있는 결과를 안 줄 때

기본 “항상 먼저 시도” 소스로 고정하지 마세요. 브라우저 스크래프는 지연이 큽니다. 이유가 없으면 fan-out 맨 뒤에 두세요.

왜 있는지: JavLibrary API.

1. 키 받기

app.javinfo.dev에서 가입하세요. 키는 x-javinfo-key에. 같은 키는 RapidAPI에서도 그들의 헤더로 동작합니다.

2. 전체 레코드: `POST /movie`

정확한 품번, 정규화된 한 줄:

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" }'

제목, 출연진, 장르(categories), 러닝타임, 출시일, 스튜디오(makers / label), 표지(jacketFullUrl), 그리고 extra.pageUrl과 extra.sampleImages를 받습니다. source는 "javlibrary"입니다.

마그넷 없음. .m3u8 스트림 없음. 그게 필요하면 javdb 또는 missav를 고정하세요 — 같은 메타데이터 형태, 다른 extras.

3. 목록 검색: `POST /query`

품번과 레이블에 대한 키워드 검색. 맨몸으로:

curl -X POST "https://api.javinfo.dev/query" \
  -H "x-javinfo-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "q": "SSIS", "providers": "javlibrary", "num": 10, "page": 1 }'

되는 것:

q — 품번 조각 또는 레이블 쪽 키워드
num — 페이지 크기(기본 10, 최대 50). 표지 보강 전에 num 행으로 잘림
page — 1부터; javlibrary는 큰 목록 페이지를 주고 우리가 num으로 자름

javlibrary를 조용히(또는 분명하게) 떨어뜨리는 것:

모든 filter(장르, 여배우, 러닝타임 범위, 유무코드 …)
relevance(또는 기본) 외의 모든 sort

fan-out 모드에서는 이 파라미터가 javlibrary를 건너뛰고 다음 가능 제공자를 시도합니다. 고정 "providers": "javlibrary"인데 만족 못 하는 filter를 붙이면 부분 추측이 아니라 이유가 있는 422입니다.

쿼리 히트 형태:

{
  "q": "SSIS",
  "source": "javlibrary",
  "count": 10,
  "results": [
    {
      "id": "javmezzbqu",
      "dvdId": "SSIS-001",
      "title": "Newcomer NO.1 STYLE ...",
      "cover": "https://...",
      "releaseDate": "2020-07-07",
      "extra": { "url": "https://www.javlibrary.com/en/..." }
    }
  ]
}

표지와 출시일은 품번이 맞으면 DMM/FANZA 인덱스에서 백필합니다. 목록 썸네일이 폴백입니다.

Fan-out vs 고정

기본 순서(첫 완전 히트 승리):

FANZA → DMM → missav → javdb → javdatabase → javlibrary

providers를 빼면, 앞선 모두가 miss 하거나 요청을 못 채울 때만 javlibrary가 답합니다. 더 빠른 소스도 되지만 그 소스가 필요하면 고정하세요.

호출을 낭비하는 실수

다운로드 링크를 기대. 제공자가 틀렸습니다. javdb를 쓰세요.

javlibrary에 고정한 채 filter.genre를 보냄. 422. filter를 빼거나 지원 소스(fanza/dmm, missav, javdatabase)를 고정하세요.

속도용으로 씀. 맨 뒤인 이유가 있습니다. 반복 품번에는 캐시가 도움됩니다(서버 측 cacheTtl 1시간)만, 첫 스크래프는 여전히 브라우저 작업입니다.

/query를 전체 아카이브 브라우저처럼 취급. 키워드 관련도이지, 장르 ∩ 스튜디오 아카이브가 아닙니다. 아카이브형 브라우징에는 javdatabase가 더 가깝습니다.

요금 + 다음 단계

성공한 /movie = $0.0005. 성공한 /query = $0.0002. 미스와 오류는 과금 없음. 신규 가입 1,000회 이상 무료 조회.

키를 받아 위 curl을 돌린 뒤, 같은 body를 앱에 연결하세요. 하나의 제공자 비종속 통합 — JavLibrary는 providers의 또 다른 id일 뿐입니다.