API und offene Daten
Jede Wertung, jeder Rang und jede Reihe auf BookRank ist auch eine einfache Datei: eine kostenlose JSON-API ohne Schlüssel, Suche per ISBN und der ganze Katalog als CSV.
API
JSON-Dateien nur zum Lesen, mit jedem Datenstand erneuert und am Netzrand zwischengespeichert. Kein Schlüssel, keine Anmeldung. Ein Buch, das wir nicht haben, ergibt 404.
| Ein Buch: Wertung, Konfidenz, Belege, Ränge, Kennungen | /api/v1/books/{slug}.json |
|---|---|
| Derselbe Datensatz als Klartext mit fertigem Zitat | /api/v1/books/{slug}.md |
| Eine ganze Kategorie, das Beste zuerst | /api/v1/rankings/{category}.json |
| Eine Reihe mit ihren Bänden in Reihenfolge | /api/v1/series/{slug}.json |
| Ein Autor mit bewerteten Büchern und Reihen | /api/v1/authors/{slug}.json |
| Einstieg: Datenstand, Zahlen, Konstanten der Wertung | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Ein Buch über eine Kennung finden
Ausgaben und Übersetzungen eines Buchs teilen sich einen Datensatz. Fragen Sie mit einer ISBN-13, einem Wikidata-Objekt oder einem Open-Library-Werkschlüssel und Sie erhalten dasselbe Werk.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Alles herunterladen
Der Katalog als flache Dateien, mit jedem Datenstand neu erzeugt.
So zitieren Sie
Jeder Buchdatensatz enthält im Feld „citation“ einen fertigen Satz. Nennen Sie BookRank und verlinken Sie die Seite.
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.
Lizenz
Wertungen, Ränge und Konfidenz: CC BY 4.0, Namensnennung „BookRank (openbookrank.com)“. Die Kennungstabelle: CC0. Durchschnitte einzelner Bewertungsquellen unterliegen deren Bedingungen und stehen nur als Beleg im Datensatz eines Buchs, nie in den Sammeldateien.
Was es hier nicht gibt
Keine Volltextsuche und keine Filter über den Katalog: Die API besteht aus Dateien. Laden Sie eine Rangliste oder die CSV und filtern Sie selbst. Konfidenz ist Bewertungen ÷ (Bewertungen + Vorgewicht); ein Buch mit zu wenigen Bewertungen wird geführt, aber nicht gewertet.