API & open data
Every score, rank and series on BookRank is also a plain file: a free JSON API with no key, lookups by ISBN, and the whole catalogue as CSV.
API
Read-only JSON files, refreshed with every snapshot and cached at the edge. No key and no sign-up. A book we do not have is a 404.
| One book: score, confidence, evidence, ranks, identifiers | /api/v1/books/{slug}.json |
|---|---|
| The same record as plain text with a ready citation | /api/v1/books/{slug}.md |
| A whole category, best first | /api/v1/rankings/{category}.json |
| A series with its volumes in order | /api/v1/series/{slug}.json |
| An author with ranked books and series | /api/v1/authors/{slug}.json |
| Entry point: snapshot, counts, scoring constants | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Find a book by an identifier
Editions and translations of one book share one record. Ask with any ISBN-13, a Wikidata item or an Open Library work key and get the same work back.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Download everything
The catalogue as flat files, rebuilt with every snapshot.
How to cite
Every book record carries a ready sentence in its “citation” field. Name BookRank and link the page.
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.
Licence
Scores, ranks and confidence: CC BY 4.0, credit “BookRank (openbookrank.com)”. The identifier crosswalk: CC0. Averages from individual rating sources come under those sources’ terms and appear only as evidence on a book’s own record, never in the bulk files.
What is not here
No free-text search and no filters across the catalogue: the API is files. Download a ranking or the CSV and filter it yourself. Confidence is ratings ÷ (ratings + prior weight); a book with too few ratings is listed but not scored.