제공업체

제공업체는 javinfo가 스크래핑하고 정규화하는 소스입니다. 모든 검색은 등록된 제공업체 전체로 fan-out되어 첫 번째 구조화된 결과를 반환하므로, 쉽게 깨지는 스크래퍼를 직접 유지 관리할 필요 없이 한 번의 호출로 메타데이터, 마그넷 및 스트림을 얻을 수 있습니다. API가 선택하도록 두거나(fan-out) 원하는 정확한 소스를 고정할 수 있습니다.

제공업체 목록

fanza와 dmm은 두 DMM + FANZA 스토어프론트입니다. 이들의 쿼리 ID는 query:fanza, query:dmm, query:missav, query:javdb, query:javdatabase입니다.

제공업체 선택

기본값: fan-out

providers를 생략하면 등록된 모든 제공업체가 후보입니다. API는 순서대로 시도하며, 요청을 완전히 충족하는 첫 번째 제공업체가 승리합니다:

FANZA → DMM → missav → javdb → javdatabase

/query에서는 filter/sort를 충족할 수 없는 제공업체가 조용히 건너뛰어지고 워터폴은 다음으로 진행합니다. /movie와 /random에는 필터가 없으므로 단순히 첫 번째 결과가 승리합니다. 응답한 제공업체는 source로 다시 반영됩니다:

{ "q": "SSIS-001", "source": "fanza", "result": { "...": "..." } }

providers로 고정

특정 소스(또는 집합)를 강제하려면 providers를 보내세요. query: 접두사가 있든 없든 배열 또는 쉼표 목록을 받습니다:

curl -s -X POST https://api.javinfo.dev/query \
  -H "x-javinfo-key: $KEY" -H 'content-type: application/json' \
  -d '{ "q": "ABP", "providers": ["javdb"], "sort": "rating" }'

"providers": "javdb", ["fanza","missav"], "query:javdb"는 모두 유효합니다. 고정된 제공업체가 /query에서 요청을 충족할 수 없으면 건너뛰어지지 않습니다 — 호출은 422와 이유를 명시하는 message와 함께 실패합니다(알 수 없는 ID는 400). 오류를 참조하세요.

제공업체 선택은 세 가지 영역을 좌우합니다:

• /query — 고정, 워터폴, 필터별 기능. 어떤 제공업체가 어떤 filter/sort를 지원하는지가 시스템의 핵심입니다; 전체 기능 매트릭스를 참조하세요.
• /movie / /random — 필터 없음; 승자는 source로 반영됩니다.
• MCP 서버 — javinfo-search / javinfo-movie 도구는 자체 providers 인수를 받습니다(여기서 javdb는 movie 전용임에 유의).

각 제공업체

fanza / dmm

DMM + FANZA 스토어프론트이자 가장 풍부한 구조화된 소스: 모든 이름 지정 차원 (genre, actress, maker, series, director, label, actor)을 자유롭게 결합하며, 영어 장르/이름 값, 분 단위 재생 시간 필터, sort: release, 페이지 매김을 지원합니다. 검열본 카탈로그 전용 — uncensored 필터는 이들을 제외합니다.

missav

가장 넓은 필터 범위이자 스트림 소스(.m3u8 URL)입니다. 모든 이름 지정 차원(장르는 일본어, 예: 巨乳), 재생 시간 및 출시일 범위 모두, censored 양방향을 지원합니다. 트레이드오프: 정렬 없음(관련성만)과 실제 페이지 매김 없음(항상 1페이지).

javdb

필드별 필터는 없지만 최고의 정렬과 다운로드 소스입니다. 대략적인 censored 탭(양방향), availability(playable / magnets / subtitle / single), 그리고 풍부한 sort(relevance / release / update / rating)만 제공합니다. 페이지 매김 지원. 마그넷과 다운로드 링크를 위해 고정하세요.

javdatabase

단일 차원으로 아카이브 탐색 — genre, actress, maker, series, director — genre + maker만 결합됩니다(장르 ∩ 스튜디오 아카이브). 영어 값, 자동 슬러그화 ("S1 NO.1 STYLE" → s1-no-1-style). 검열본 및 무검열. 페이지 매김 지원, 최신순. 설명과 샘플 이미지에 적합합니다.

다음

• 필터링 — 전체 제공업체별 기능 매트릭스와 /query 치트 시트.
• MCP 서버 — 도구 인수로서의 제공업체.
• API 참조 — 라이브 플레이그라운드와 함께 모든 엔드포인트.