제공업체

제공업체는 javinfo가 집계·정규화하는 소스입니다. 검색은 등록된 제공업체로 fan-out되어 첫 구조화 결과를 반환합니다. 한 번의 호출로 메타데이터, 마그넷, 스트림을 얻고 스크래퍼는 필요 없습니다. API가 고르게 하거나 소스를 고정하세요.

제공업체 목록링크 복사

fanza와 dmm은 두 DMM + FANZA 스토어프론트입니다. 쿼리 ID: query:fanza, query:dmm, query:javdatabase, query:sextb, query:javlibrary, query:javbus, query:missav, query:javdb.

제공업체 선택링크 복사

기본값: fan-out링크 복사

providers를 생략하면 모든 등록 제공업체가 후보입니다. API가 순서대로 시도해 요청을 충족하는 첫 번째가 이깁니다:

FANZA → DMM → javdatabase → sextb → javlibrary → javbus → missav → javdb

missav까지 일곱은 자체 인덱스에서 밀리초 응답. javdb는 실시간으로 가져와 뒤 폴백 계층에. /movie는 마지막 둘을 바꿔 javdb를 missav 앞에.

/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링크 복사

영어 사이트의 자체 카탈로그. 완전한 필터링: 모든 이름 지정 차원, 두 범위, 검열본과 무검열. 영어 값만 쓰고 자동 슬러그화는 없으며 일본어 q는 건너뜁니다. 페이지 매김, sort: release 작동. 설명과 샘플 이미지에 적합.

sextb링크 복사

자체 카탈로그의 스트림: 모든 이름 지정 차원, 두 범위, censored 양방향. 작품에 일반 메타데이터와 함께 .m3u8 URL이 붙습니다. 페이지 매김, sort: release 작동.

javlibrary링크 복사

심층 카탈로그, 전부 자체 보유. /movie는 제목, 출연진, 장르, 재생 시간, 출시일, 스튜디오, 재킷, 샘플 이미지를 반환하는 코드 조회(마그넷·스트림 없음). /query는 완전 검색: 모든 이름 지정 차원, 두 범위, sort: release, 검열본 전용. 페이지 매김. 스토어프론트가 코드를 놓쳤을 때 쓰세요.

javbus링크 복사

javbus 카탈로그 크롤링 사본: 약 663,000작품, 검열본·무검열, 시간당 상한 없이 자체 인덱스 제공. 영어·일본어 제목, 출연진, 장르, 제작사, 레이블, 시리즈, 감독, 재킷, 갤러리를 담습니다.

/query는 actor를 뺀 모든 이름 지정 차원, 두 범위, censored 양방향. 여배우, 제작사, 장르 값은 일본어나 영어와 일치(三上悠亜와 Yua Mikami 둘 다 동작). 정렬은 relevance 또는 release뿐, 결과는 페이지 매김. availability 없음.

/movie는 토렌트도 줍니다: 각 마그넷은 이름, 정보 해시, 마그넷 URI, 바이트 크기, hd, cnsub, createdAt을 담은 result.extra.downloadLinks 항목.

curl -s 'https://api.javinfo.dev/movie?q=BEB-001&providers=javbus' \
  -H "x-javinfo-key: jvi_your_key_here"

{
  "q": "BEB-001",
  "source": "javbus",
  "result": {
    "contentId": null,
    "dvdId": "BEB-001",
    "titleEn": "Hot kiss and embrace JULIA of Bijin Older Sister living in the neighbor",
    "titleJa": "隣に住んでいる美人お姉さんの、熱い接吻と抱擁 JULIA",
    "commentEn": null,
    "commentJa": null,
    "runtimeMins": 118,
    "releaseDate": "2010-12-19",
    "makers": ["Bi"],
    "label": "Bicchi",
    "series": "Hotkissandembraceof○○OlderSisterlivingin",
    "categories": ["Slut", "Threesome / Foursome"],
    "actresses": ["JULIA"],
    "actors": [],
    "directors": ["Sion."],
    "authors": [],
    "jacketFullUrl": "https://www.javbus.com/pics/cover/18gl_b.jpg",
    "jacketThumbUrl": "https://www.javbus.com/pics/thumb/18gl.jpg",
    "site": "javbus",
    "serviceCode": null,
    "extra": {
      "actressesRich": [
        {
          "name": "JULIA",
          "image": "https://www.javbus.com/pics/actress/2de_a.jpg"
        }
      ],
      "sampleUrl": null,
      "galleryFull": [
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001jp-1.jpg",
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001jp-2.jpg"
      ],
      "galleryThumb": [
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001-1.jpg",
        "https://pics.dmm.co.jp/digital/video/beb00001/beb00001-2.jpg"
      ],
      "downloadLinks": [
        {
          "name": "BEB-001",
          "hash": "0d640b95d94676448e6faa075b88e701191037d9",
          "magnet": "magnet:?xt=urn:btih:0D640B95D94676448E6FAA075B88E701191037D9&dn=BEB-001",
          "url": null,
          "size": 1642824991,
          "hd": false,
          "cnsub": false,
          "filesCount": null,
          "createdAt": "2026-09-11"
        }
      ],
      "pageUrl": "https://www.javbus.com/en/BEB-001"
    }
  }
}

배열 필드는 첫 한두 항목으로 축약.

다음링크 복사

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