提供商
javinfo 聚合的数据源、各自返回什么，以及如何用 providers 固定一个。
提供商（provider）是 javinfo 聚合并规范化的数据源。每次搜索向已注册提供商扇出， 返回第一个结构化命中：一次调用拿到元数据、磁力和流媒体，无需维护爬虫。可以让 API 自动选择，也可以固定某个源。
提供商名录
| 提供商 | 最适合 | 返回内容 | 端点 |
|---|---|---|---|
fanza、dmm | 最丰富的结构化元数据与筛选 | 元数据、封面、样品图（有码目录） | /movie、/query、/random |
missav | 流媒体与最广的筛选面 | .m3u8 流媒体 URL、日文类型、时长 + 发布日期范围 | /movie、/query |
javdb | 下载链接与排序 | 磁力 / 下载链接、评分、availability | /movie、/query |
javdatabase | 描述与图片 | 描述文本、样品图、归档浏览 | /movie、/query |
sextb | 流媒体与无码影片 | .m3u8 流媒体、元数据、有码 + 无码 | /movie、/query |
javlibrary | 深度目录兜底 | 元数据、封面、样品图 | /movie、/query |
javbus | 种子与日文元数据 | 元数据、封面、图集、磁力 | /movie、/query |
fanza 和 dmm 是 DMM + FANZA 的两个店面。查询 id：
query:fanza、query:dmm、query:javdatabase、query:sextb、query:javlibrary、query:javbus、query:missav、query:javdb。
选择提供商
默认：扇出
省略 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在那里仅限影片）。
各提供商详解
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
自有英文站目录。完整筛选：每个具名维度自由组合，外加两种范围，覆盖有码与
无码。仅英文值，不做自动 slug 化；日文 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 加上种子：每个磁力是 result.extra.downloadLinks 中的一条，带名称、
info hash、磁力 URI、字节大小、hd、cnsub 和 createdAt。
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"
}
}
}数组只保留前一两项。