プロバイダー

プロバイダーは javinfo がスクレイプして正規化するソースです。すべての検索は 登録済みプロバイダーに対してファンアウトし、最初の構造化ヒットを返すため、1回の 呼び出しでメタデータ、マグネット、ストリームが得られ、壊れやすいスクレイパーを 維持する必要はありません。API に選ばせる（ファンアウト）か、必要なソースを正確に **ピン留め（pin）**することができます。

ラインナップ

fanza と dmm は DMM + FANZA の2つのストアフロントです。それぞれのクエリ ID は query:fanza、query:dmm、query:missav、query:javdb、query:javdatabase です。

プロバイダーの選択

デフォルト：ファンアウト

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）。エラーを参照。

プロバイダーの選択は3つの領域を制御します：

• /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 のみです（ジャンル ∩ スタジオのアーカイブ）。英語の値で、自動的に slug 化されます（"S1 NO.1 STYLE" → s1-no-1-style）。モザイクありと無修正。ページング対応で、新しい順。説明文や サンプル画像に適しています。

次へ

• フィルタリング — プロバイダー別の完全な対応マトリクスと /query チートシート。
• MCP サーバー — ツール引数としてのプロバイダー。
• API リファレンス — すべてのエンドポイントをライブプレイグラウンド 付きで。