{"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"},{"name":"Books"},{"name":"Authors"}],"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","schema":{"type":"string"},"example":"the hobbit"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"title":"The Lord of the Rings","author":"J.R.R. Tolkien","source":"Open Library","work_id":"OL27448W","subjects":["The Lord of the Rings","Fiction","Ficción","English Fantasy fiction","Ficción fantástica inglesa","Fantasy fiction","Open Library Staff Picks","Middle Earth (Imaginary place)"],"already_read":222,"rating_count":112,"want_to_read":2272,"rating_average":4.438,"first_published":"September 3, 2001","open_library_url":"https://openlibrary.org/works/OL27448W","currently_reading":191,"star_distribution":{"1":3,"2":5,"3":9,"4":18,"5":77}},"meta":{"timestamp":"2026-06-12T01:42:14.738Z","request_id":"2c818ef7-43b9-4a7a-83fb-4a83b1a473ab"},"status":"ok","message":"Book retrieved successfully","success":true}}}},"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":"Results (1-25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"dune","total":44544,"source":"Open Library","results":[{"title":"Dune","author":"Frank Herbert","work_id":"OL893415W","already_read":681,"rating_count":423,"want_to_read":3284,"rating_average":4.305,"first_published":1965},{"title":"Dune Messiah","author":"Frank Herbert","work_id":"OL893526W","already_read":244,"rating_count":137,"want_to_read":530,"rating_average":3.956,"first_published":1969},{"title":"Children of Dune","author":"Frank Herbert","work_id":"OL893516W","already_read":126,"rating_count":42,"want_to_read":267,"rating_average":4,"first_published":1976},{"title":"Heretics of Dune","author":"Frank Herbert","work_id":"OL893502W","already_read":91,"rating_count":50,"want_to_read":131,"rating_average":3.86,"first_published":1984},{"title":"God Emperor of Dune","author":"Frank Herbert","work_id":"OL893515W","already_read":131,"rating_count":74,"want_to_read":165,"rating_average":3.946,"first_published":1981},{"title":"Chapterhouse Dune","author":"Frank Herbert","work_id":"OL893508W","already_read":51,"rating_count":20,"want_to_read":123,"rating_average":3.9,"first_published":1985},{"title":"The Great Dune Trilogy","author":"Frank Herbert","work_id":"OL893444W","already_read":21,"rating_count":20,"want_to_read":17,"rating_average":4.2,"first_published":1977},{"title":"Go Ask Alice","author":"Beatrice Sparks","work_id":"OL264729W","already_read":119,"rating_count":51,"want_to_read":644,"rating_average":3.686,"first_published":1971},{"title":"Dune","author":"Brian Herbert","work_id":"OL19618275W","already_read":24,"rating_count":15,"want_to_read":7,"rating_average":3.267,"first_published":2001},{"title":"Sandworms of Dune","author":"Kevin J. Anderson","work_id":"OL14961045W","already_read":19,"rating_count":17,"want_to_read":21,"rating_average":3.412,"first_published":2007}]},"meta":{"timestamp":"2026-06-12T01:42:15.344Z","request_id":"52d51daf-3507-440f-8a89-18bf1a9aa182"},"status":"ok","message":"Search retrieved successfully","success":true}}}},"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","content":{"application/json":{"example":{"data":{"name":"Brandon Sanderson","source":"Open Library","top_work":"The Final Empire","author_key":"OL1394865A","birth_date":"19 December 1975","work_count":190,"top_subjects":["Fiction, fantasy, general","Fiction","Fiction, fantasy, epic","Fantasy","Fantasy fiction","New York Times bestseller","Children's fiction","Magic"],"open_library_url":"https://openlibrary.org/authors/OL1394865A"},"meta":{"timestamp":"2026-06-12T01:42:15.677Z","request_id":"7d3ffd39-1893-42a8-9a44-2336c228d2bf"},"status":"ok","message":"Author retrieved successfully","success":true}}}},"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","content":{"application/json":{"example":{"data":{"note":"Look up a book by its Open Library work id (work=OL27448W) or by title (title=the hobbit). Reading-log counts (want-to-read, currently-reading, already-read) come from the community's bookshelves.","source":"Open Library public API (openlibrary.org, live)","service":"bookstats-api","endpoints":{"GET /v1/book":"A book's reader stats — rating distribution and reading-log counts (work=OL27448W or title=dune).","GET /v1/meta":"This document.","GET /v1/author":"An author's profile — work count, top work, dates (author=brandon sanderson).","GET /v1/search":"Search books with ratings and want-to-read counts (q=dune)."},"description":"Live reader-community stats for books from Open Library (the Internet Archive's open book catalog). The reading-community view of a book — how readers rate it and how many want to read, are reading or have already read it. book = a title's reader stats (average rating, full 1-5 star distribution, reading-log counts, authors, year, subjects); search = search books, each with its rating and want-to-read count; author = an author's profile (work count, top work, dates). Live, no key, nothing stored. The community-engagement layer, distinct from the plain book-catalog and reading-trends APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:42:15.771Z","request_id":"c165aa02-df28-4430-9410-3df784882852"},"status":"ok","message":"Meta","success":true}}}},"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/isbn":{"get":{"operationId":"get_v1_isbn","tags":["Books"],"summary":"Resolve an ISBN to its book, edition details and work id","description":"","parameters":[{"name":"isbn","in":"query","required":true,"description":"ISBN-10 or ISBN-13","schema":{"type":"string"},"example":"9780547928227"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"isbn":"9780547928227","pages":300,"title":"The Hobbit","source":"Open Library","work_id":"OL27482W","work_url":"https://openlibrary.org/works/OL27482W","languages":["eng"],"publishers":["Mariner Books"],"publish_date":"2012","physical_format":"Paperback","open_library_url":"https://openlibrary.org/isbn/9780547928227"},"meta":{"timestamp":"2026-06-13T13:54:29.068Z","request_id":"3f242447-aaac-4366-95fb-8ff3619b7f29"},"status":"ok","message":"ISBN resolved successfully","success":true}}}},"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-works":{"get":{"operationId":"get_v1_author_works","tags":["Authors"],"summary":"An author bibliography, each book with rating and want-to-read","description":"","parameters":[{"name":"author","in":"query","required":true,"description":"Author name","schema":{"type":"string"},"example":"brandon sanderson"},{"name":"sort","in":"query","required":false,"description":"rating, new, old, already_read or want_to_read","schema":{"type":"string"},"example":"rating"},{"name":"limit","in":"query","required":false,"description":"Results (1-50)","schema":{"type":"string"},"example":"15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"rating","count":15,"works":[{"title":"Words of Radiance","work_id":"OL16813053W","already_read":149,"rating_count":89,"want_to_read":268,"edition_count":22,"rating_average":4.685,"first_published":2012,"open_library_url":"https://openlibrary.org/works/OL16813053W"},{"title":"The Hero of Ages","work_id":"OL5738154W","already_read":176,"rating_count":120,"want_to_read":178,"edition_count":27,"rating_average":4.583,"first_published":2008,"open_library_url":"https://openlibrary.org/works/OL5738154W"},{"title":"The Way of Kings","work_id":"OL15358691W","already_read":242,"rating_count":155,"want_to_read":826,"edition_count":30,"rating_average":4.535,"first_published":2010,"open_library_url":"https://openlibrary.org/works/OL15358691W"},{"title":"Oathbringer","work_id":"OL17834026W","already_read":125,"rating_count":87,"want_to_read":223,"edition_count":16,"rating_average":4.552,"first_published":2017,"open_library_url":"https://openlibrary.org/works/OL17834026W"},{"title":"The Final Empire","work_id":"OL5738148W","already_read":246,"rating_count":147,"want_to_read":1159,"edition_count":44,"rating_average":4.422,"first_published":2001,"open_library_url":"https://openlibrary.org/works/OL5738148W"},{"title":"The Well of Ascension","work_id":"OL5738150W","already_read":213,"rating_count":135,"want_to_read":261,"edition_count":36,"rating_average":4.407,"first_published":2007,"open_library_url":"https://openlibrary.org/works/OL5738150W"},{"title":"Rhythm of War","work_id":"OL20842226W","already_read":81,"rating_count":41,"want_to_read":152,"edition_count":14,"rating_average":4.463,"first_published":2011,"open_library_url":"https://openlibrary.org/works/OL20842226W"},{"title":"Elantris","work_id":"OL5738147W","already_read":137,"rating_count":95,"want_to_read":258,"edition_count":33,"rating_average":4.179,"first_published":2005,"open_library_url":"https://openlibrary.org/works/OL5738147W"},{"title":"Shadows of Self","work_id":"OL17349393W","already_read":104,"rating_count":59,"want_to_read":97,"edition_count":18,"rating_average":4.254,"first_published":2015,"open_library_url":"https://openlibrary.org/works/OL17349393W"},{"title":"Arcanum Unbounded","work_id":"OL17770504W","already_read":32,"rating_count":20,"want_to_read":72,"edition_count":13,"rating_average":4.6,"first_published":2016,"open_library_url":"https://openlibrary.org/works/OL17770504W"},{"title":"Starsight","work_id":"OL19075470W","already_read":36,"rating_count":25,"want_to_read":55,"edition_count":16,"rating_average":4.48,"first_published":2019,"open_library_url":"https://openlibrary.org/works/OL19075470W"},{"title":"The Emperor's Soul","work_id":"OL19960448W","already_read":76,"rating_count":50,"want_to_read":86,"edition_count":11,"rating_average":4.26,"first_published":2012,"open_library_url":"https://openlibrary.org/works/OL19960448W"},{"title":"The Alloy of Law","work_id":"OL16597059W","already_read":126,"rating_count":83,"want_to_read":160,"edition_count":24,"rating_average":4.12,"first_published":2001,"open_library_url":"https://openlibrary.org/works/OL16597059W"},{"title":"The Gathering Storm","work_id":"OL1946681W","already_read":75,"rating_count":50,"want_to_read":107,"edition_count":19,"rating_average":4.22,"first_published":2009,"open_library_url":"https://openlibrary.org/works/OL1946681W"},{"title":"Skyward","work_id":"OL18191919W","already_read":59,"rating_count":43,"want_to_read":121,"edition_count":17,"rating_average":4.233,"first_published":2018,"open_library_url":"https://openlibrary.org/works/OL18191919W"}],"author":"Brandon Sanderson","source":"Open Library","author_key":"OL1394865A","total_works":190},"meta":{"timestamp":"2026-06-13T13:54:29.581Z","request_id":"527269b7-e488-4d1b-8072-cc9b4c8ee0a7"},"status":"ok","message":"Author works retrieved successfully","success":true}}}},"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"}