提供商

**提供商（provider）是 javinfo 抓取并规范化的一个数据源。每次搜索都会向已注册的 提供商扇出（fan-out），并返回第一个结构化命中结果 — 这样一次调用就能给你元数据、 磁力链接和流媒体链接，而无需自己维护经常出问题的爬虫。你可以让 API 自动选择 （扇出），也可以固定（pin）**你想要的确切数据源。

提供商名录

fanza 和 dmm 是 DMM + FANZA 的两个店面。它们的查询 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）。参见 错误处理。

提供商选择驱动三个层面：

• /query — 固定、瀑布流以及按筛选条件的能力。哪个提供商支持哪个 filter/sort 是整个系统的关键；参见完整的 能力矩阵。
• /movie / /random — 无筛选；胜出者作为 source 回显。
• MCP 服务器 — javinfo-search / javinfo-movie 工具接受它们 自己的 providers 参数（注意 javdb 在那里仅限影片）。

各提供商详解

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 参考 — 每个端点都附带在线调试工具。