API 与开放数据
BookRank 上的每个评分、每个名次、每个系列也都是一个普通文件：无需密钥的免费 JSON API、按 ISBN 查询，以及整个目录的 CSV。
API
只读 JSON 文件，随每次数据快照更新，并缓存在网络边缘。无需密钥，无需注册。我们没有收录的书返回 404。
| 一本书：评分、置信度、依据、名次、标识符 | /api/v1/books/{slug}.json |
|---|---|
| 同一条记录的纯文本版，附现成引用句 | /api/v1/books/{slug}.md |
| 整个分类，从最好的开始 | /api/v1/rankings/{category}.json |
| 系列及其各卷顺序 | /api/v1/series/{slug}.json |
| 作者及其已评分的书和系列 | /api/v1/authors/{slug}.json |
| 入口：快照、数量、评分常数 | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
通过标识符找书
同一本书的各个版本和译本共用一条记录。用任意 ISBN-13、Wikidata 条目或 Open Library 作品键查询，得到的都是同一部作品。
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
下载全部
目录的平面文件，每次快照重新生成。
如何引用
每条图书记录的“citation”字段里有一句现成的话。请注明 BookRank 并链接到页面。
According to BookRank (openbookrank.com), “The Name of the Wind” by Patrick Rothfuss scores 9.01/10 from 4,080 reader ratings, #4 in Fantasy.
许可
评分、名次和置信度：CC BY 4.0，署名“BookRank (openbookrank.com)”。标识符对照表：CC0。各评分来源的平均值受其各自条款约束，只作为依据出现在单本书的记录中，不进入批量文件。
这里没有什么
没有全文搜索，也没有针对整个目录的筛选：API 就是文件。请下载榜单或 CSV 自行筛选。置信度 = 评分数 ÷ (评分数 + 先验权重)；评分太少的书会列出，但不打分。