{"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"},{"name":"Book"}],"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/search":{"get":{"operationId":"get_v1_search","tags":["Trends"],"summary":"Reading-engagement search — books with rating and shelf counts","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-50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"books":[{"id":"OL893415W","url":"https://openlibrary.org/works/OL893415W","title":"Dune","author":"Frank Herbert","authors":["Frank Herbert"],"cover_id":11481354,"already_read":686,"rating_count":426,"want_to_read":3291,"edition_count":120,"rating_average":4.31,"first_published":1965,"currently_reading":251},{"id":"OL893526W","url":"https://openlibrary.org/works/OL893526W","title":"Dune Messiah","author":"Frank Herbert","authors":["Frank Herbert"],"cover_id":2421405,"already_read":244,"rating_count":137,"want_to_read":530,"edition_count":70,"rating_average":3.96,"first_published":1969,"currently_reading":41},{"id":"OL893516W","url":"https://openlibrary.org/works/OL893516W","title":"Children of Dune","author":"Frank Herbert","authors":["Frank Herbert"],"cover_id":6976407,"already_read":130,"rating_count":46,"want_to_read":270,"edition_count":51,"rating_average":3.96,"first_published":1976,"currently_reading":21},{"id":"OL893502W","url":"https://openlibrary.org/works/OL893502W","title":"Heretics of Dune","author":"Frank Herbert","authors":["Frank Herbert"],"cover_id":284530,"already_read":91,"rating_count":50,"want_to_read":131,"edition_count":35,"rating_average":3.86,"first_published":1984,"currently_reading":7},{"id":"OL893515W","url":"https://openlibrary.org/works/OL893515W","title":"God Emperor of Dune","author":"Frank Herbert","authors":["Frank Herbert"],"cover_id":6711531,"already_read":131,"rating_count":74,"want_to_read":165,"edition_count":40,"rating_average":3.95,"first_published":1981,"currently_reading":5},{"id":"OL893508W","url":"https://openlibrary.org/works/OL893508W","title":"Chapterhouse Dune","author":"Frank Herbert","authors":["Frank Herbert"],"cover_id":5536140,"already_read":51,"rating_count":20,"want_to_read":123,"edition_count":35,"rating_average":3.9,"first_published":1985,"currently_reading":3},{"id":"OL893444W","url":"https://openlibrary.org/works/OL893444W","title":"The Great Dune Trilogy","author":"Frank Herbert","authors":["Frank Herbert"],"cover_id":379932,"already_read":21,"rating_count":20,"want_to_read":17,"edition_count":8,"rating_average":4.2,"first_published":1977,"currently_reading":2},{"id":"OL264729W","url":"https://openlibrary.org/works/OL264729W","title":"Go Ask Alice","author":"Beatrice Sparks","authors":["Beatrice Sparks"],"cover_id":8749018,"already_read":119,"rating_count":51,"want_to_read":644,"edition_count":41,"rating_average":3.69,"first_published":1971,"currently_reading":47},{"id":"OL19618275W","url":"https://openlibrary.org/works/OL19618275W","title":"Dune","author":"Brian Herbert","authors":["Brian Herbert","Kevin J. Anderson"],"cover_id":372916,"already_read":24,"rating_count":15,"want_to_read":7,"edition_count":10,"rating_average":3.27,"first_published":2001,"currently_reading":0},{"id":"OL14961045W","url":"https://openlibrary.org/works/OL14961045W","title":"Sandworms of Dune","author":"Kevin J. Anderson","authors":["Kevin J. Anderson","Brian Herbert","Brian Herbert"],"cover_id":524596,"already_read":19,"rating_count":17,"want_to_read":21,"edition_count":6,"rating_average":3.41,"first_published":2007,"currently_reading":0}],"count":10,"query":"dune","total":44557},"meta":{"timestamp":"2026-06-13T14:11:00.126Z","request_id":"25ece5b8-3d2d-4806-bc38-551c5a65cfcc"},"status":"ok","message":"Search results 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/subject":{"get":{"operationId":"get_v1_subject","tags":["Trends"],"summary":"The most-held books in a subject/genre","description":"","parameters":[{"name":"subject","in":"query","required":true,"description":"Subject/genre slug","schema":{"type":"string"},"example":"fantasy"},{"name":"limit","in":"query","required":false,"description":"Results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"books":[{"id":"OL138052W","url":"https://openlibrary.org/works/OL138052W","rank":1,"title":"Alice's Adventures in Wonderland","author":"Lewis Carroll","authors":["Lewis Carroll"],"cover_id":10527843,"edition_count":3547,"first_published":1865},{"id":"OL18417W","url":"https://openlibrary.org/works/OL18417W","rank":2,"title":"The Wonderful Wizard of Oz","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":552443,"edition_count":2049,"first_published":1899},{"id":"OL24034W","url":"https://openlibrary.org/works/OL24034W","rank":3,"title":"Treasure Island","author":"Robert Louis Stevenson","authors":["Robert Louis Stevenson"],"cover_id":13859660,"edition_count":1988,"first_published":1880},{"id":"OL20600W","url":"https://openlibrary.org/works/OL20600W","rank":4,"title":"Gulliver's Travels","author":"Jonathan Swift","authors":["Jonathan Swift"],"cover_id":12717083,"edition_count":1810,"first_published":1726},{"id":"OL259010W","url":"https://openlibrary.org/works/OL259010W","rank":5,"title":"A Midsummer Night's Dream","author":"William Shakespeare","authors":["William Shakespeare"],"cover_id":7205924,"edition_count":1505,"first_published":1600},{"id":"OL1089297W","url":"https://openlibrary.org/works/OL1089297W","rank":6,"title":"The Prince","author":"Niccolò Machiavelli","authors":["Niccolò Machiavelli"],"cover_id":12726168,"edition_count":1407,"first_published":1515},{"id":"OL151406W","url":"https://openlibrary.org/works/OL151406W","rank":7,"title":"Through the Looking-Glass","author":"Lewis Carroll","authors":["Lewis Carroll"],"cover_id":11272464,"edition_count":1379,"first_published":1865},{"id":"OL28570037W","url":"https://openlibrary.org/works/OL28570037W","rank":8,"title":"The Wind in the Willows","author":"Kenneth Grahame","authors":["Kenneth Grahame"],"cover_id":13335427,"edition_count":1346,"first_published":1908},{"id":"OL99499W","url":"https://openlibrary.org/works/OL99499W","rank":9,"title":"Five Children and It","author":"Edith Nesbit","authors":["Edith Nesbit"],"cover_id":28174,"edition_count":950,"first_published":1905},{"id":"OL15449W","url":"https://openlibrary.org/works/OL15449W","rank":10,"title":"The Princess and the Goblin","author":"George MacDonald","authors":["George MacDonald"],"cover_id":14363454,"edition_count":750,"first_published":1872},{"id":"OL262460W","url":"https://openlibrary.org/works/OL262460W","rank":11,"title":"The Lost World","author":"Arthur Conan Doyle","authors":["Arthur Conan Doyle"],"cover_id":8231444,"edition_count":747,"first_published":1900},{"id":"OL18396W","url":"https://openlibrary.org/works/OL18396W","rank":12,"title":"The Marvelous Land of Oz","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":12648656,"edition_count":724,"first_published":1904},{"id":"OL18415W","url":"https://openlibrary.org/works/OL18415W","rank":13,"title":"Ozma of Oz","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":12648657,"edition_count":701,"first_published":1907},{"id":"OL10263W","url":"https://openlibrary.org/works/OL10263W","rank":14,"title":"Le petit prince","author":"Antoine de Saint-Exupéry","authors":["Antoine de Saint-Exupéry"],"cover_id":10708272,"edition_count":688,"first_published":1943},{"id":"OL18409W","url":"https://openlibrary.org/works/OL18409W","rank":15,"title":"The Emerald City of Oz","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":1473556,"edition_count":634,"first_published":1910},{"id":"OL18412W","url":"https://openlibrary.org/works/OL18412W","rank":16,"title":"Dorothy and the Wizard in Oz","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":12648659,"edition_count":622,"first_published":1908},{"id":"OL18411W","url":"https://openlibrary.org/works/OL18411W","rank":17,"title":"The Lost Princess of Oz","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":854819,"edition_count":591,"first_published":1917},{"id":"OL407476W","url":"https://openlibrary.org/works/OL407476W","rank":18,"title":"The Story of the Amulet","author":"Edith Nesbit","authors":["Edith Nesbit"],"cover_id":13241470,"edition_count":578,"first_published":1905},{"id":"OL262358W","url":"https://openlibrary.org/works/OL262358W","rank":19,"title":"The Complete Life and Adventures of Santa Claus","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":1979059,"edition_count":560,"first_published":1902},{"id":"OL151411W","url":"https://openlibrary.org/works/OL151411W","rank":20,"title":"Alice's Adventures in Wonderland / Through the Looking Glass","author":"Lewis Carroll","authors":["Lewis Carroll"],"cover_id":8595966,"edition_count":544,"first_published":1889},{"id":"OL1168083W","url":"https://openlibrary.org/works/OL1168083W","rank":21,"title":"Nineteen Eighty-Four","author":"George Orwell","authors":["George Orwell"],"cover_id":9267242,"edition_count":536,"first_published":1949},{"id":"OL262390W","url":"https://openlibrary.org/works/OL262390W","rank":22,"title":"The Road to Oz","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":8243922,"edition_count":533,"first_published":1909},{"id":"OL262384W","url":"https://openlibrary.org/works/OL262384W","rank":23,"title":"The Sea Fairies","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":1814237,"edition_count":528,"first_published":1911},{"id":"OL262341W","url":"https://openlibrary.org/works/OL262341W","rank":24,"title":"Baum's American Fairy Tales","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":709869,"edition_count":514,"first_published":1901},{"id":"OL262385W","url":"https://openlibrary.org/works/OL262385W","rank":25,"title":"Sky Island","author":"L. Frank Baum","authors":["L. Frank Baum"],"cover_id":2752804,"edition_count":510,"first_published":1912}],"count":25,"subject":"fantasy","work_count":14441},"meta":{"timestamp":"2026-06-13T14:11:01.348Z","request_id":"3543a602-70a3-4867-849b-fa335195dae5"},"status":"ok","message":"Subject 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/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 or forever","schema":{"type":"string"},"example":"daily"},{"name":"limit","in":"query","required":false,"description":"Results (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"}