API och öppna data
Varje betyg, varje placering och varje serie på BookRank är också en vanlig fil: ett gratis JSON-API utan nyckel, sökning på ISBN och hela katalogen som CSV.
API
Skrivskyddade JSON-filer som förnyas med varje ögonblicksbild och cachas vid nätverkets kant. Ingen nyckel, ingen registrering. En bok vi inte har ger 404.
| En bok: betyg, säkerhet, underlag, placeringar, identifierare | /api/v1/books/{slug}.json |
|---|---|
| Samma post som ren text med ett färdigt citat | /api/v1/books/{slug}.md |
| En hel kategori, bäst först | /api/v1/rankings/{category}.json |
| En serie med delarna i ordning | /api/v1/series/{slug}.json |
| En författare med betygsatta böcker och serier | /api/v1/authors/{slug}.json |
| Startpunkt: ögonblicksbild, antal, konstanter för betyget | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Hitta en bok via en identifierare
Utgåvor och översättningar av en bok delar en post. Fråga med valfritt ISBN-13, ett Wikidata-objekt eller en verksnyckel från Open Library och få samma verk tillbaka.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Ladda ner allt
Katalogen som platta filer, byggd på nytt med varje ögonblicksbild.
Så citerar du
Varje bokpost har en färdig mening i fältet ”citation”. Nämn BookRank och länka till sidan.
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.
Licens
Betyg, placeringar och säkerhet: CC BY 4.0, med angivelsen ”BookRank (openbookrank.com)”. Identifierartabellen: CC0. Medelvärden från enskilda betygskällor lyder under de källornas villkor och visas bara som underlag i en boks egen post, aldrig i massfilerna.
Vad som inte finns här
Ingen fritextsökning och inga filter över katalogen: API:et är filer. Ladda ner en rankning eller CSV-filen och filtrera själv. Säkerhet är betyg ÷ (betyg + förhandsvikt); en bok med för få betyg listas men får inget betyg.