API en open data
Elke score, elke plaats en elke serie op BookRank is ook een gewoon bestand: een gratis JSON-API zonder sleutel, zoeken op ISBN en de hele catalogus als CSV.
API
Alleen-lezen JSON-bestanden, vernieuwd bij elke momentopname en gecachet aan de rand van het netwerk. Geen sleutel, geen registratie. Een boek dat we niet hebben geeft 404.
| Eén boek: score, betrouwbaarheid, bewijs, plaatsen, identificatoren | /api/v1/books/{slug}.json |
|---|---|
| Hetzelfde record als platte tekst met een kant-en-klaar citaat | /api/v1/books/{slug}.md |
| Een hele categorie, de beste eerst | /api/v1/rankings/{category}.json |
| Een serie met de delen op volgorde | /api/v1/series/{slug}.json |
| Een auteur met beoordeelde boeken en series | /api/v1/authors/{slug}.json |
| Startpunt: momentopname, aantallen, constanten van de score | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Vind een boek via een identificator
Edities en vertalingen van één boek delen één record. Vraag met een ISBN-13, een Wikidata-item of een Open Library-werksleutel en je krijgt hetzelfde werk terug.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Download alles
De catalogus als platte bestanden, opnieuw opgebouwd bij elke momentopname.
Zo citeer je
Elk boekrecord bevat een kant-en-klare zin in het veld ‘citation’. Noem BookRank en link naar de pagina.
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.
Licentie
Scores, plaatsen en betrouwbaarheid: CC BY 4.0, met de vermelding ‘BookRank (openbookrank.com)’. De identificatortabel: CC0. Gemiddelden van afzonderlijke beoordelingsbronnen vallen onder de voorwaarden van die bronnen en staan alleen als bewijs in het record van een boek, nooit in de bulkbestanden.
Wat hier niet is
Geen vrij zoeken en geen filters over de catalogus: de API bestaat uit bestanden. Download een ranglijst of de CSV en filter zelf. Betrouwbaarheid is beoordelingen ÷ (beoordelingen + voorgewicht); een boek met te weinig beoordelingen staat in de lijst, maar zonder score.