API y datos abiertos
Cada puntuación, cada puesto y cada saga de BookRank es también un archivo: una API JSON gratuita y sin clave, búsqueda por ISBN y todo el catálogo en CSV.
API
Archivos JSON de solo lectura, renovados con cada instantánea y guardados en caché en el borde de la red. Sin clave ni registro. Un libro que no tenemos devuelve 404.
| Un libro: puntuación, confianza, pruebas, puestos, identificadores | /api/v1/books/{slug}.json |
|---|---|
| El mismo registro en texto plano con una cita lista | /api/v1/books/{slug}.md |
| Una categoría entera, de mejor a peor | /api/v1/rankings/{category}.json |
| Una saga con sus volúmenes en orden | /api/v1/series/{slug}.json |
| Un autor con sus libros puntuados y sus sagas | /api/v1/authors/{slug}.json |
| Punto de entrada: instantánea, recuentos, constantes de puntuación | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Encuentra un libro por un identificador
Las ediciones y traducciones de un libro comparten un registro. Pregunta con cualquier ISBN-13, un elemento de Wikidata o una clave de obra de Open Library y obtendrás la misma obra.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Descárgalo todo
El catálogo en archivos planos, regenerado con cada instantánea.
Cómo citar
Cada registro de libro trae una frase lista en el campo «citation». Nombra BookRank y enlaza la página.
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.
Licencia
Puntuaciones, puestos y confianza: CC BY 4.0, con el crédito «BookRank (openbookrank.com)». La tabla de identificadores: CC0. Las medias de cada fuente de valoraciones se rigen por las condiciones de esas fuentes y aparecen solo como prueba en el registro de un libro, nunca en los archivos masivos.
Lo que no hay aquí
No hay búsqueda de texto libre ni filtros sobre el catálogo: la API son archivos. Descarga un ranking o el CSV y fíltralo tú. La confianza es valoraciones ÷ (valoraciones + peso previo); un libro con muy pocas valoraciones aparece, pero sin puntuación.