{"openapi":"3.1.0","info":{"title":"Book Reader Stats API","version":"1.0.0","description":"Live reader-community stats for books from Open Library (the Internet Archive's open book catalog) — no key, nothing stored. This is the reading-community view of a book: how readers rate it and how many want to read, are reading or have already read it, distinct from the plain book-catalog and reading-trends APIs in the catalogue — this is the community-engagement layer, not the bibliographic record. The book endpoint returns a title's reader stats: the average rating, the full 1-5 star distribution, and the reading-log counts (want-to-read, currently-reading, already-read), with its authors, first-published year and subjects. The search endpoint searches books and returns each match with its rating and want-to-read count, so you can find a work and its Open Library id. The author endpoint returns an author's profile — work count, top work and dates. Build reading dashboards, book-recommendation widgets, \"most wanted\" charts and community-sentiment tools on top of real Open Library data. Look up a book by its Open Library work id (work=OL27448W) or by title (title=the hobbit); reading-log counts come from the community's bookshelves.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bookstats-api","description":"oanor gateway"}],"tags":[{"name":"Book"},{"name":"Search"},{"name":"Author"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/book":{"get":{"operationId":"get_v1_book","tags":["Book"],"summary":"A book reader stats — ratings and reading-log","description":"","parameters":[{"name":"work","in":"query","required":false,"description":"Open Library work id","schema":{"type":"string"},"example":"OL27448W"},{"name":"title","in":"query","required":false,"description":"Book title (resolved via search)","schema":{"type":"string"},"example":"the hobbit"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search books with ratings and want-to-read","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"dune"},{"name":"limit","in":"query","required":false,"description":"Max results (default 10, max 25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/author":{"get":{"operationId":"get_v1_author","tags":["Author"],"summary":"An author profile — work count, top work","description":"","parameters":[{"name":"author","in":"query","required":true,"description":"Author name","schema":{"type":"string"},"example":"brandon sanderson"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":25000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":460,"monthly_call_quota":330000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1380,"monthly_call_quota":1400000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":3260,"monthly_call_quota":5000000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bookstats-api"}