{"openapi":"3.1.0","info":{"title":"Books API","version":"1.0.0","description":"Search millions of books, look up editions by ISBN-10/13 and find authors — with covers, publish years, publishers, page counts and subjects. Powered by Open Library (Internet Archive).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/books-api","description":"oanor gateway"}],"tags":[{"name":"Books"}],"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/author":{"get":{"operationId":"get_v1_author","tags":["Books"],"summary":"Search authors","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Author name","schema":{"type":"string"},"example":"tolkien"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"tolkien","authors":[{"key":"OL2623360A","name":"Christopher Tolkien","top_work":"The War of the Ring","birth_date":"21 November 1924","work_count":43},{"key":"OL14431239A","name":"F. Tolkien","top_work":"Thug Life","work_count":23},{"key":"OL26320A","name":"J.R.R. Tolkien","top_work":"The Hobbit","birth_date":"3 January 1892","work_count":403},{"key":"OL1477672A","name":"Simon Tolkien","top_work":"Final Witness","birth_date":"1959","work_count":18},{"key":"OL2977155A","name":"Michael Tolkien","top_work":"Rainbow","work_count":8},{"key":"OL38677A","name":"Tracy Tolkien","top_work":"A collector's guide to costume jewelry","birth_date":"1962","work_count":7},{"key":"OL10273437A","name":"Simon Tolkien","top_work":"Room of Lost Steps","work_count":6},{"key":"OL15812868A","name":"J.R.R. Tolkien","top_work":"The Lord of the Rings Part One the Fellowship of the Ring","work_count":6},{"key":"OL14454981A","name":"F. U. N. Tolkien","top_work":"Balance in Life > Than Anything","work_count":6},{"key":"OL2447931A","name":"James Kenneth Tolkien","top_work":"The inn of Gahnobway: [poems]","birth_date":"1881","work_count":3},{"key":"OL14991321A","name":"Christopher Tolkien","top_work":"Tree and Leaf","work_count":3},{"key":"OL15445861A","name":"Tolkien","top_work":"The Rankin/Bass Production of The Hobbit, Based on the Original Version of The Hobbit written by J.R.R. Tolkien (Read-Along Book and Record #368)","work_count":1},{"key":"OL12057534A","name":"Michael Tolkien","top_work":"Exposures","birth_date":"1943","work_count":2},{"key":"OL7925803A","name":"Hartmut Tolkien","top_work":"Schmierwirkungen in Schmiedegesenken","work_count":2},{"key":"OL12409183A","name":"George Tolkien","top_work":"Hinduism","work_count":1},{"key":"OL676461A","name":"John Tolkien","top_work":"The Tolkien family album","birth_date":"1917","work_count":1},{"key":"OL6206934A","name":"Susan Tolkien","top_work":"The performance of gel entrapped Streptomyces clavuligerus producing clavulanic acid","work_count":1},{"key":"OL14699176A","name":"Ed Tolkien","top_work":"Simple Sourdoughs","work_count":1},{"key":"OL14499862A","name":"Dzon Tolkien","top_work":"Hobit","work_count":1},{"key":"OL15303987A","name":"Christopher Tolkien ","top_work":"The Silmarillion ","work_count":1}]},"meta":{"timestamp":"2026-05-30T02:21:56.721Z","request_id":"576724c0-0239-4282-b94d-1382a8b7efea"},"status":"ok","message":"Authors 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/isbn":{"get":{"operationId":"get_v1_isbn","tags":["Books"],"summary":"Book details by ISBN","description":"","parameters":[{"name":"isbn","in":"query","required":true,"description":"ISBN-10 or ISBN-13","schema":{"type":"string"},"example":"9780261103344"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"url":"http://openlibrary.org/books/OL10236414M/The_Hobbit","isbn":"9780261103344","cover":"https://covers.openlibrary.org/b/id/10522108-M.jpg","title":"The Hobbit","authors":["J.R.R. Tolkien"],"subjects":["Fantasy","Arkenstone","Battle of Five Armies","invisibility","thrushes","eagles","hobbits","wizards","dragons","dwarves"],"subtitle":"or There and Back Again","publishers":["HarperCollins Publishers"],"publish_date":"2011"},"meta":{"timestamp":"2026-05-30T02:21:57.594Z","request_id":"edc5221d-6900-4f97-9f18-6a5daf754cba"},"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":["Books"],"summary":"Search books","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Free-text query","schema":{"type":"string"},"example":"lord of the rings"},{"name":"title","in":"query","required":false,"description":"Title","schema":{"type":"string"},"example":"the hobbit"},{"name":"author","in":"query","required":false,"description":"Author","schema":{"type":"string"},"example":"tolkien"},{"name":"limit","in":"query","required":false,"description":"Max 1-50","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"books":[{"isbn":"0007525524","cover":"https://covers.openlibrary.org/b/id/255844-M.jpg","title":"Novels (Hobbit / Lord of the Rings)","authors":["J.R.R. Tolkien"],"subjects":["Fiction, fantasy, epic","Middle earth (imaginary place), fiction","Baggins, frodo (fictitious character), fiction","Baggins, bilbo (fictitious character), fiction","Gandalf (fictitious character), fiction","Science fiction, fantasy, horror","British and irish fiction (fictional works by one author)","Fiction, fantasy, general"],"work_key":"/works/OL14926019W","languages":["rus","eng"],"edition_count":24,"first_publish_year":1979},{"isbn":"9780395282656","cover":"https://covers.openlibrary.org/b/id/14627509-M.jpg","title":"The Hobbit","authors":["J.R.R. Tolkien"],"subjects":["Fantasy","Arkenstone","Battle of Five Armies","invisibility","thrushes","eagles","hobbits","wizards"],"work_key":"/works/OL27482W","languages":["cor","ger","nob","heb","pol","vie","spa","cat","ang","epo","jpn","rum","lez","dut","gle","eng","lat","tur","por","swe","rus","dan","chi","cze","bul","ita","yid","fin","fre","bre"],"edition_count":462,"first_publish_year":1937},{"isbn":"5170097468","title":"The Hobbit / Lord of the Rings / Silmarillion","authors":["J.R.R. Tolkien"],"subjects":[],"work_key":"/works/OL14933367W","languages":["rus"],"edition_count":1,"first_publish_year":2004},{"isbn":"144586150X","cover":"https://covers.openlibrary.org/b/id/10670029-M.jpg","title":"The Lord of the Rings and The Hobbit","authors":["J.R.R. Tolkien"],"subjects":[],"work_key":"/works/OL24214484W","languages":[],"edition_count":1,"first_publish_year":2011},{"isbn":"912409546X","title":"The Hobbit & The Lord of the Rings 4 Books Boxed Set By J. R. R. Tolkien","authors":["J.R.R. Tolkien"],"subjects":[],"work_key":"/works/OL27741781W","languages":[],"edition_count":1,"first_publish_year":2021},{"isbn":"9780008802394","title":"The Hobbit and The Lord of the Rings","authors":["J. R. R. Tolkien"],"subjects":[],"work_key":"/works/OL45346395W","languages":[],"edition_count":1},{"isbn":"9780008260187","title":"Hobbit and the Lord of the Rings Gift Set","authors":["J.R.R. Tolkien"],"subjects":["English literature"],"work_key":"/works/OL26328786W","languages":["eng"],"edition_count":1,"first_publish_year":2017},{"isbn":"9780063451964","title":"Hobbit and the Lord of the Rings Illustrated by Alan Lee Box Set","authors":["J.R.R. Tolkien"],"subjects":[],"work_key":"/works/OL42554726W","languages":["eng"],"edition_count":1,"first_publish_year":2025},{"isbn":"9781559946759","cover":"https://covers.openlibrary.org/b/id/788355-M.jpg","title":"The J. R. R. Tolkien Audio Collection (Adventures of Tom Bombadil / Hobbit / Lord of the Rings / Road Goes Ever On / The Silmarillion)","authors":["J.R.R. Tolkien"],"subjects":[],"work_key":"/works/OL14933402W","languages":["eng"],"edition_count":1,"first_publish_year":1992},{"isbn":"9781637997345","title":"Collector's Edition, the Hobbit, the Silmarillion, the Fellowship of the Ring, the Two Towers, the Return of the King (the Lord of the Rings Vol. 1-3), 5 Books Set, by J.R.R. Tolkien","authors":["J.R.R. Tolkien"],"subjects":["Fiction, fantasy, general"],"work_key":"/works/OL44576580W","languages":["eng"],"edition_count":1,"first_publish_year":2024}],"count":10,"found":10},"meta":{"timestamp":"2026-05-30T02:21:58.827Z","request_id":"7d51c00b-4e6b-490a-87ab-b28796364f1c"},"status":"ok","message":"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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":80000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":400000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":1500000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/books-api"}