博客

作者 javinfo team

JavLibrary API:深度目录查询,无需爬取站点

JavLibrary 没有公开 API。在 /movie 或 /query 上指定 providers: "javlibrary",即可拿到标题、演员、封面和样片——其他来源都 miss 时的最后兜底。

JavLibrary 是那些难找番号最后藏的地方。目录巨大,英文界面,还有别的站悄悄丢掉的发行历史。它唯独从没出过公开的 JavLibrary API。GitHub 上一搜全是和 Cloudflare 死磕海报与演员表的爬虫——周末玩玩还行,凌晨三点页面结构一变就是灾难。

javinfo 把 javlibrary 当成真正的数据源来跑。端点和别的来源一样。你发番号,我们回 JSON。

你实际能拿到什么

POST /movie 上固定 providers: "javlibrary",就是一次番号查询:标题、演员、类型、时长、发行日、厂商、封面、样片图,以及 JavLibrary 页面 URL。没有磁力,没有 HLS 流。这是目录元数据,不是下载跳板——要那些请用 JavDBMissAV

查询番号
curl -X POST "https://api.javinfo.dev/movie" \
-H "x-javinfo-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "q": "SSIS-001", "providers": "javlibrary" }'
响应(javlibrary)
{
"q": "SSIS-001",
"source": "javlibrary",
"result": {
"dvdId": "SSIS-001",
"titleEn": "Newcomer NO.1 STYLE ...",
"runtimeMins": 120,
"releaseDate": "2020-07-07",
"makers": ["S1 NO.1 STYLE"],
"categories": ["Beautiful Girl", "Slender"],
"actresses": ["Example Actress"],
"jacketFullUrl": "https://...",
"site": "javlibrary",
"extra": {
"pageUrl": "https://www.javlibrary.com/en/...",
"sampleImages": ["https://..."]
}
}
}

基础 result 形状和 JAV 元数据 API 里其他来源一样。你的解析器不用给 JavLibrary 单独开分支。

为什么排在最后

这个数据源走浏览器抓取(那个域名上的 Cloudflare 绕不开),所以是我们最慢的来源。默认瀑布故意把它放在末尾:

FANZA → DMM → missav → javdb → javdatabase → javlibrary

把它当成深度目录的收尾者——更快的 API 都放鸽子时,它往往还在。你确定要 JavLibrary 时再固定它;要速度、只当兜底时就别动它。

/query 也能用,但只是对番号和厂牌的裸关键词搜索。会尊重 numpage。过滤和花哨排序会把它排除。完整步骤见:如何使用 JavLibrary 数据源

别自己再写爬虫了

JavLibrary 爬虫是第二份工作:Camoufox 或 FlareSolverr、年龄门 cookie、一碰就碎的选择器,CF 心情不好就超时的页面。那一套我们已经在服务端跑着。你只调一个与数据源无关的端点,像读 javdatabase 或其他任何来源一样读 result.*

app.javinfo.dev 注册,拿密钥,放进 x-javinfo-keyRapidAPI 上也可用)。按用量计费:/movie 每次成功 $0.0005,/query $0.0002,失败免费。新账号 1,000+ 次免费查询,无需绑卡。一分钟就能打通一次真实请求。