API e dati aperti
Ogni punteggio, ogni posizione e ogni serie di BookRank è anche un semplice file: un’API JSON gratuita e senza chiave, la ricerca per ISBN e l’intero catalogo in CSV.
API
File JSON di sola lettura, rinnovati a ogni istantanea e tenuti in cache al bordo della rete. Nessuna chiave, nessuna registrazione. Un libro che non abbiamo restituisce 404.
| Un libro: punteggio, confidenza, prove, posizioni, identificatori | /api/v1/books/{slug}.json |
|---|---|
| La stessa scheda in testo semplice con una citazione pronta | /api/v1/books/{slug}.md |
| Un’intera categoria, dal migliore in giù | /api/v1/rankings/{category}.json |
| Una serie con i volumi in ordine | /api/v1/series/{slug}.json |
| Un autore con i libri valutati e le serie | /api/v1/authors/{slug}.json |
| Punto d’ingresso: istantanea, conteggi, costanti del punteggio | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Trova un libro da un identificatore
Edizioni e traduzioni di un libro condividono una sola scheda. Chiedi con qualsiasi ISBN-13, un elemento Wikidata o una chiave d’opera di Open Library e ottieni la stessa opera.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Scarica tutto
Il catalogo in file piatti, rigenerato a ogni istantanea.
Come citare
Ogni scheda di libro contiene una frase pronta nel campo «citation». Nomina BookRank e metti il link alla 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.
Licenza
Punteggi, posizioni e confidenza: CC BY 4.0, con l’attribuzione «BookRank (openbookrank.com)». La tabella degli identificatori: CC0. Le medie delle singole fonti di valutazioni seguono le condizioni di quelle fonti e compaiono solo come prova nella scheda di un libro, mai nei file complessivi.
Che cosa non c’è
Niente ricerca a testo libero né filtri sul catalogo: l’API è fatta di file. Scarica una classifica o il CSV e filtra da te. La confidenza è valutazioni ÷ (valutazioni + peso a priori); un libro con troppo poche valutazioni è elencato ma senza punteggio.