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 自行篩選。信賴度 = 評分數 ÷ (評分數 + 先驗權重)；評分太少的書會列出，但不評分。