{"openapi":"3.1.0","info":{"title":"BookRank API","version":"v1 (2026-09-21)","description":"Static, read-only JSON: book scores, rankings, series, authors and an identifier crosswalk.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"email":"kontakt@bril.pl"}},"servers":[{"url":"https://openbookrank.com/api/v1"}],"paths":{"/index.json":{"get":{"summary":"Entry point: snapshot, counts, endpoints, scoring constants","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/books/{slug}.json":{"get":{"summary":"One work: score, confidence, evidence, ranks, identifiers, relations","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/books/{slug}.md":{"get":{"summary":"The same record as plain text, with a ready citation","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/markdown":{}}}}}},"/isbn/{isbn13}.json":{"get":{"summary":"ISBN-13 → work","parameters":[{"name":"isbn13","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/wikidata/{qid}.json":{"get":{"summary":"Wikidata item → work","parameters":[{"name":"qid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/openlibrary/{workKey}.json":{"get":{"summary":"Open Library work key → work","parameters":[{"name":"workKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/rankings/index.json":{"get":{"summary":"Every category with its size","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/rankings/{category}.json":{"get":{"summary":"A whole category, best first","parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/series/{slug}.json":{"get":{"summary":"A series with its volumes in order","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}},"/authors/{slug}.json":{"get":{"summary":"An author with ranked books, series and similar authors","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}},"404":{"description":"Not in the catalogue"}}}}}}