APIとオープンデータ
BookRankのスコア、順位、シリーズはすべて単純なファイルとしても公開しています。キー不要の無料JSON API、ISBNでの検索、カタログ全体のCSVです。
API
読み取り専用のJSONファイルです。スナップショットごとに更新され、ネットワークのエッジでキャッシュされます。キーも登録も不要です。収録していない本は404を返します。
| 1冊の本：スコア、信頼度、根拠、順位、識別子 | /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 |
識別子から本を探す
1冊の本の各版と翻訳は1つのレコードを共有します。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をダウンロードして手元で絞り込んでください。信頼度は 評価数 ÷ (評価数 + 事前の重み) です。評価が少なすぎる本は掲載しますが採点しません。