博客

作者 javinfo team

Javdatabase API:无需访问网站,即可获取 javdatabase.com 的数据

在搜索 javdatabase.com?通过一个 API 即可获取任意 JAV 番号的英文描述、样片图库和预告片链接 —— 标准化 JSON,无需爬虫。

javdatabase.com 是了解一部作品的好去处之一 —— 地道的英文描述、精选的样片图库,偶尔还有预告片。但它是一个为浏览而生的网站,而不是一个你能直接调用的数据库。javdatabase 没有公开的 API。如果你想在应用里用到这些数据,你只有两个选择:打开一个浏览器标签页,或者自己写爬虫。javinfo 给你第三个选择。

拿到数据,无需网站

javinfo 把 javdatabase 作为一个数据源来运行。使用 POST /movie 并传入 providers: "javdatabase",你就能拿到这个网站最擅长的字段 —— 完整的英文 description(而不是一句话的简介)、sampleImages,以及在存在时的 trailerUrl —— 而且这些都基于标准基础字段:标题、演员阵容、发行日期、封面。

查询影片
curl -X POST "https://api.javinfo.dev/movie" \
-H "x-javinfo-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "q": "SSIS-001", "providers": "javdatabase" }'
响应(javdatabase)
{
"q": "SSIS-001",
"source": "javdatabase",
"result": {
"dvdId": "SSIS-001",
"titleEn": "After Abstaining From Sex...",
"extra": {
"description": "A newlywed wife succumbs to temptation...",
"sampleImages": ["https://www.javdatabase.com/images/samples/ssis-001_1.webp"],
"trailerUrl": "https://www.javdatabase.com/trailers/ssis-001.mp4"
}
}
}

为什么不直接爬取 javdatabase.com

因为爬虫是一项维护负担,而不是一次集成。你得解析随时会变、又没有更新日志的 HTML,跟网站接下来加的各种反爬机制较劲,还得在它某天悄悄返回空白的那个早晨重写你的解析器。javinfo 把这件事在服务端做一次,转而交给你一份稳定的 JSON 契约。当页面结构变动时,由我们来修复;你的代码继续调用同一个端点。

一种结构,所有来源

/movie 端点可以对接全部四个数据源 —— dmm/fanza、javdb、missav、javdatabase —— 无论由哪个来源回答,都会返回同一个标准化的 result。所以来自 javdatabase 的描述和样片,与 JavDB 的磁力链接MissAV 的在线流 采用完全相同的结构。你可以固定 "providers": "javdatabase",也可以让默认顺序去尝试,在 javdatabase 拥有最佳答案时采用它。这是一个覆盖所有来源的 JAV 元数据 API从设计上就与数据源无关 —— 与那种可查询数据库的思路相同,只是固定到了一个数据源。

app.javinfo.dev 注册,获取一个密钥,并通过 x-javinfo-key 请求头传入(也可以在 RapidAPI 上使用)。按用量计费:/movie 每个成功结果 $0.00075,/query 每个 $0.00035,失败的查询免费。新注册用户可获得 50 次免费查询,无需信用卡。(那个同时干两件事的旧 /search 端点正在被替换 —— 阅读关于端点拆分的内容。)你一分钟内就能跑起来。