{"openapi":"3.1.0","info":{"title":"Reading Trends API","version":"1.0.0","description":"A live read on what the Open Library reading community is into right now, as an API. Pull the trending books over the last day, week, month or year — with author, first-published year and edition count — or open a book for its social reading stats: the average star rating and number of ratings, and how many people have it on their \"want to read\", \"currently reading\" and \"already read\" shelves. The pulse of community reading delivered as clean JSON for book, social and dashboard apps. Live data, no key. Distinct from book-catalogue search/ISBN APIs — this is the reading-popularity and shelf-engagement layer.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/readingtrends-api","description":"oanor gateway"}],"tags":[{"name":"Trends"},{"name":"Books"},{"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/trending":{"get":{"operationId":"get_v1_trending","tags":["Trends"],"summary":"Trending books by period","description":"","parameters":[{"name":"period","in":"query","required":false,"description":"now | daily | weekly | monthly | yearly | forever","schema":{"type":"string"},"example":"daily"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"books":[{"id":"OL17930368W","url":"https://openlibrary.org/works/OL17930368W","rank":1,"title":"Atomic Habits","author":"James Clear","authors":["James Clear"],"cover_id":12539702,"edition_count":40,"first_published":2016},{"id":"OL2010879W","url":"https://openlibrary.org/works/OL2010879W","rank":2,"title":"Rich Dad, Poor Dad","author":"Robert T. Kiyosaki","authors":["Robert T. Kiyosaki","Sharon L. Lechter"],"cover_id":8315603,"edition_count":115,"first_published":1990},{"id":"OL1968368W","url":"https://openlibrary.org/works/OL1968368W","rank":3,"title":"The 48 Laws of Power","author":"Robert Greene","authors":["Robert Greene"],"cover_id":6424160,"edition_count":55,"first_published":1998},{"id":"OL21640039W","url":"https://openlibrary.org/works/OL21640039W","rank":4,"title":"The Psychology of Money","author":"Morgan Housel","authors":["Morgan Housel"],"cover_id":10389354,"edition_count":26,"first_published":2020},{"id":"OL42430111W","url":"https://openlibrary.org/works/OL42430111W","rank":5,"title":"The Deal","author":"Elle Kennedy","authors":["Elle Kennedy"],"cover_id":10201611,"edition_count":14,"first_published":2000},{"id":"OL22057778W","url":"https://openlibrary.org/works/OL22057778W","rank":6,"title":"The Mistake","author":"Elle Kennedy","authors":["Elle Kennedy"],"cover_id":10420220,"edition_count":9,"first_published":2015},{"id":"OL21516735W","url":"https://openlibrary.org/works/OL21516735W","rank":7,"title":"Her Secret, His Child","author":"Miranda Lee","authors":["Miranda Lee","Anne McAllister","Christina Hollis"],"cover_id":12630209,"edition_count":2,"first_published":2013},{"id":"OL471603W","url":"https://openlibrary.org/works/OL471603W","rank":8,"title":"The Mystery of the Blue Train","author":"Agatha Christie","authors":["Agatha Christie"],"cover_id":14575533,"edition_count":124,"first_published":1928},{"id":"OL36733687W","url":"https://openlibrary.org/works/OL36733687W","rank":9,"title":"The Deal / The Mistake / The Score / The Goal / The Legacy","author":"Elle Kennedy","authors":["Elle Kennedy"],"cover_id":15217419,"edition_count":2,"first_published":2021},{"id":"OL1968364W","url":"https://openlibrary.org/works/OL1968364W","rank":10,"title":"The Art of Seduction","author":"Robert Greene","authors":["Robert Greene","Joost Elffers"],"cover_id":917840,"edition_count":22,"first_published":2001},{"id":"OL82563W","url":"https://openlibrary.org/works/OL82563W","rank":11,"title":"Harry Potter and the Philosopher's Stone","author":"J. K. Rowling","authors":["J. K. Rowling"],"cover_id":15155833,"edition_count":398,"first_published":1997},{"id":"OL262421W","url":"https://openlibrary.org/works/OL262421W","rank":12,"title":"The Adventures of Sherlock Holmes [12 stories]","author":"Arthur Conan Doyle","authors":["Arthur Conan Doyle"],"cover_id":6717853,"edition_count":1132,"first_published":1892},{"id":"OL19761410W","url":"https://openlibrary.org/works/OL19761410W","rank":13,"title":"The Laws of Human Nature","author":"Robert Greene","authors":["Robert Greene"],"cover_id":10170095,"edition_count":9,"first_published":2018},{"id":"OL27482W","url":"https://openlibrary.org/works/OL27482W","rank":14,"title":"The Hobbit","author":"J.R.R. Tolkien","authors":["J.R.R. Tolkien"],"cover_id":14627509,"edition_count":462,"first_published":1937},{"id":"OL27310398W","url":"https://openlibrary.org/works/OL27310398W","rank":15,"title":"Haunting Adeline","author":"H. D. Carlton","authors":["H. D. Carlton"],"cover_id":12992962,"edition_count":16,"first_published":2021},{"id":"OL16444438W","url":"https://openlibrary.org/works/OL16444438W","rank":16,"title":"The Fault in Our Stars","author":"John Green","authors":["John Green"],"cover_id":7418786,"edition_count":80,"first_published":2010},{"id":"OL18108064W","url":"https://openlibrary.org/works/OL18108064W","rank":17,"title":"Can't Hurt Me","author":"David Goggins","authors":["David Goggins"],"cover_id":8305903,"edition_count":11,"first_published":2018},{"id":"OL8483260W","url":"https://openlibrary.org/works/OL8483260W","rank":18,"title":"Diary of a Wimpy Kid","author":"Jeff Kinney","authors":["Jeff Kinney"],"cover_id":14376136,"edition_count":96,"first_published":2007},{"id":"OL24141033W","url":"https://openlibrary.org/works/OL24141033W","rank":19,"title":"The Score","author":"Elle Kennedy","authors":["Elle Kennedy"],"cover_id":10538493,"edition_count":8,"first_published":2016},{"id":"OL46881W","url":"https://openlibrary.org/works/OL46881W","rank":20,"title":"Jurassic Park","author":"Michael Crichton","authors":["Michael Crichton"],"cover_id":12882940,"edition_count":93,"first_published":1990},{"id":"OL42611094W","url":"https://openlibrary.org/works/OL42611094W","rank":21,"title":"Gunaho ka Devta","authors":[],"cover_id":14851422,"edition_count":1,"first_published":2020},{"id":"OL527464W","url":"https://openlibrary.org/works/OL527464W","rank":22,"title":"Think and Grow Rich","author":"Napoleon Hill","authors":["Napoleon Hill"],"cover_id":14542536,"edition_count":309,"first_published":1937},{"id":"OL25436364W","url":"https://openlibrary.org/works/OL25436364W","rank":23,"title":"The Mountain Is You","author":"Brianna Wiest","authors":["Brianna Wiest"],"cover_id":13838236,"edition_count":7,"first_published":2020},{"id":"OL1063267W","url":"https://openlibrary.org/works/OL1063267W","rank":24,"title":"How to Win Friends and Influence People","author":"Dale Carnegie","authors":["Dale Carnegie"],"cover_id":13314878,"edition_count":178,"first_published":1936},{"id":"OL15715631W","url":"https://openlibrary.org/works/OL15715631W","rank":25,"title":"Pretence Of Love","author":"Carol Gregor","authors":["Carol Gregor"],"cover_id":5071590,"edition_count":1,"first_published":1991}],"count":25,"period":"daily"},"meta":{"timestamp":"2026-06-09T03:02:55.795Z","request_id":"acc3b3f1-24f3-4b84-97b6-d505bd5517de"},"status":"ok","message":"Trending books 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/book":{"get":{"operationId":"get_v1_book","tags":["Books"],"summary":"A book's social reading stats","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Open Library work id","schema":{"type":"string"},"example":"OL17930368W"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"book":{"id":"OL17930368W","url":"https://openlibrary.org/works/OL17930368W","title":"Atomic Habits","subjects":["Habit","Habit breaking","Behavior modification","Self-actualization (psychology)","Business","psychology","Personal Growth","New York Times bestseller","BUSINESS & ECONOMICS / Organizational Behavior","PSYCHOLOGY / Social Psychology","SELF-HELP / Personal Growth / General."],"already_read":1643,"rating_count":1372,"want_to_read":54599,"rating_average":3.97,"currently_reading":4673}},"meta":{"timestamp":"2026-06-09T03:03:04.260Z","request_id":"ce53f1a0-ad59-4a8c-a1c2-d75343d488d5"},"status":"ok","message":"Book stats 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":{"source":"Open Library trending + ratings + bookshelves (live)","periods":["now","daily","weekly","monthly","yearly","forever"],"service":"readingtrends-api","endpoints":{"GET /v1/book":"A book's social reading stats (id=OL17930368W: ratings + shelf counts).","GET /v1/meta":"This document.","GET /v1/trending":"Trending books by period (period=now|daily|weekly|monthly|yearly|forever, limit)."},"description":"Live reading-community trends from Open Library: trending books by day/week/month/year (with author, year and edition count), and per-book social reading stats — average rating, rating count, and want-to-read / currently-reading / already-read shelf counts. Live, no key. Distinct from book-catalogue search/ISBN APIs — this is the reading-popularity and engagement layer.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:03:06.297Z","request_id":"7cf3081d-d7c9-4298-8711-34ed12e54586"},"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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":700,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":14500,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1400,"monthly_call_quota":66000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":3700,"monthly_call_quota":330000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/readingtrends-api"}