{"name":"openlibrary","domain":"openlibrary.org","baseUrl":"https://openlibrary.org","displayName":"Open Library","description":"Open Library (the Internet Archive's book catalog): book search from the site's search page, and a work's or an author's record from the site's own JSON. Public, logged out.","notes":"No account is needed.\n\n- A work is a book across all its editions. Ids look like `OL59800W` (work) and `OL31353A` (author).\n- `searchBooks` returns page 1 only (20 works), ranked by the site. Several works can share a\n  title (study guides, other editions catalogued apart): pick by author and by `editions`, the\n  largest usually being the main one. `authorId` is the first author only; `author` lists them all.\n- `getWork` `description` is sometimes plain text and sometimes an object whose text is in\n  `value`. It, `subjects`, `subjectPlaces` and `coverId` are missing when the catalog has none.\n  `authorIds` are keys like `/authors/OL31353A`: the last part is the `getAuthor` arg.\n- `getAuthor`: `bio` follows the same text-or-object rule. `birthDate` and `deathDate` are\n  free text in whatever format the record has (`21 October 1929`, `January 4, 1976`), and each\n  can be missing.\n- `getEditions` returns the first 50 editions, not all editions. Edition ids are keys like\n  `/books/OL7353617M`; language values are keys like `/languages/eng`. ISBNs, publisher,\n  publication date, pages and languages may be missing.\n- `getByIsbn` accepts an ISBN-10 or ISBN-13 without hyphens. Work and author values are keys\n  such as `/works/OL45804W` and `/authors/OL34184A`, and may be absent.\n- `getAuthorWorks` returns the first 50 works. Its work ids are `/works/` keys, and first\n  publication dates are free text and often missing.\n- `getSubject` takes a subject slug such as `science_fiction` and returns the first 12 works.\n  It does not return the subject's total work count. Authors and first publication year may be\n  missing.\n- A cover image is `https://covers.openlibrary.org/b/id/<coverId>-M.jpg` (`-S`, `-M` or `-L`).","operations":[{"hash":"a65d29e7b512f8519288400f0cf825f9f92231449dcb8b0b4150d70100fda4d7","status":"live","confirmations":0,"registry":{"hash":"a65d29e7b512f8519288400f0cf825f9f92231449dcb8b0b4150d70100fda4d7","status":"live","confirmations":0},"operation":{"name":"getAuthor","description":"One author: authorId, name, birthDate, deathDate, bio and alternateNames.","request":{"method":"GET","url":"https://openlibrary.org/authors/%7BauthorId%7D.json","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"authorId","at":["path:1"],"template":"{authorId}.json"}],"volatile":[],"trigger":{"url":"https://openlibrary.org/authors/{authorId}.json"},"match":{"method":"GET","host":"openlibrary.org","path":"/authors/*"},"response":{"format":"json","contentType":"application/json","extract":".","pick":["authorId=key~/authors/(OL\\d+A)","name","birthDate=birth_date","deathDate=death_date","bio","alternateNames=alternate_names"]},"params":[{"name":"authorId","type":"string","required":true,"description":"Open Library author id, from searchBooks (or the last part of a getWork authorIds key)","example":"OL31353A","pattern":"OL\\d+A","hint":"an author id like OL31353A"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false}},{"hash":"3b86127cf7228016cc3da2058febef34849dcf91ff5ba91a842645aa3569c239","status":"live","confirmations":0,"registry":{"hash":"3b86127cf7228016cc3da2058febef34849dcf91ff5ba91a842645aa3569c239","status":"live","confirmations":0},"operation":{"name":"getAuthorWorks","description":"List the first page of an author’s works and their first publication dates when recorded.","request":{"method":"GET","url":"https://openlibrary.org/authors/%7BauthorId%7D/works.json","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"authorId","at":["path:1"]}],"volatile":[],"trigger":{"url":"https://openlibrary.org/authors/{authorId}/works.json"},"match":{"method":"GET","host":"openlibrary.org","path":"/authors/*/works.json"},"response":{"format":"json","contentType":"application/json","extract":"entries","pick":["workId=key","title","firstPublished=first_publish_date"]},"params":[{"name":"authorId","type":"string","required":true,"description":"Open Library author id, for example OL23919A","example":"OL23919A","pattern":"OL\\d+A","hint":"an author id like OL23919A"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"authorId":"OL999999999A"},"expect":"input","purpose":"A nonexistent author id returns 404"}]}},{"hash":"d1cc06d7536a3c6be1697ae447fd0041a7edf4d6cbcbb218384a87a709cad2f6","status":"live","confirmations":0,"registry":{"hash":"d1cc06d7536a3c6be1697ae447fd0041a7edf4d6cbcbb218384a87a709cad2f6","status":"live","confirmations":0},"operation":{"name":"getByIsbn","description":"Look up a book edition by ISBN.","request":{"method":"GET","url":"https://openlibrary.org/isbn/%7Bisbn%7D.json","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"isbn","at":["path:1"],"template":"{isbn}.json"}],"volatile":[],"trigger":{"url":"https://openlibrary.org/isbn/{isbn}.json"},"match":{"method":"GET","host":"openlibrary.org","path":"/isbn/*"},"response":{"format":"json","contentType":"application/json","extract":".","pick":["editionId=key","title","publishers","publishDate=publish_date","pages=number_of_pages","works=works[*].key","authors=authors[*].key"]},"params":[{"name":"isbn","type":"string","required":true,"description":"ISBN-10 or ISBN-13, without hyphens","example":"9780140328721","pattern":"(?:[0-9]{13}|[0-9]{9}[0-9Xx])","hint":"an ISBN-10 or ISBN-13 without hyphens"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"isbn":"9780141439518"},"expect":"result","purpose":"An ISBN resolves to the Pride and Prejudice edition"}]}},{"hash":"95d478211fced6828885b0ad19aaec301b17718b8d664d646d0007eb87f9e788","status":"live","confirmations":0,"registry":{"hash":"95d478211fced6828885b0ad19aaec301b17718b8d664d646d0007eb87f9e788","status":"live","confirmations":0},"operation":{"name":"getEditions","description":"List the first page of a work’s editions, including ISBNs and publication details.","request":{"method":"GET","url":"https://openlibrary.org/works/%7BworkId%7D/editions.json","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"workId","at":["path:1"]}],"volatile":[],"trigger":{"url":"https://openlibrary.org/works/{workId}/editions.json"},"match":{"method":"GET","host":"openlibrary.org","path":"/works/*/editions.json"},"response":{"format":"json","contentType":"application/json","extract":"entries","pick":["editionId=key","title","publishers","publishDate=publish_date","isbn10=isbn_10","isbn13=isbn_13","pages=number_of_pages","languages=languages[*].key"]},"params":[{"name":"workId","type":"string","required":true,"description":"Open Library work id, for example OL45804W","example":"OL45804W","pattern":"OL\\d+W","hint":"a work id like OL45804W"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"workId":"OL999999999W"},"expect":"input","purpose":"A nonexistent work id returns 404"}]}},{"hash":"80a03d4e28dc6dda90229554c8ab9642713217eadcd419fdc64844b526915762","status":"live","confirmations":0,"registry":{"hash":"80a03d4e28dc6dda90229554c8ab9642713217eadcd419fdc64844b526915762","status":"live","confirmations":0},"operation":{"name":"getSubject","description":"List the first page of works for a subject, with authors and first publication year when available.","request":{"method":"GET","url":"https://openlibrary.org/subjects/%7Bsubject%7D.json","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"subject","at":["path:1"],"template":"{subject}.json"}],"volatile":[],"trigger":{"url":"https://openlibrary.org/subjects/{subject}.json"},"match":{"method":"GET","host":"openlibrary.org","path":"/subjects/*"},"response":{"format":"json","contentType":"application/json","extract":"works","pick":["workId=key","title","authors=authors[*].name","firstPublished=first_publish_year"]},"params":[{"name":"subject","type":"string","required":true,"description":"Open Library subject slug, such as science_fiction","example":"love"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"subject":"fantasy"},"expect":"result","purpose":"Fantasy has works in the subject list"}]}},{"hash":"8dadc335ce2ade1e9a11f2e6c8128134e5f4d8f8b91c1f2a505009d1b6a45eb6","status":"live","confirmations":0,"registry":{"hash":"8dadc335ce2ade1e9a11f2e6c8128134e5f4d8f8b91c1f2a505009d1b6a45eb6","status":"live","confirmations":0},"operation":{"name":"getWork","description":"One work (a book across all its editions): workId, title, description, authorIds (\"/authors/OL31353A\" keys), subjects, subjectPlaces and coverId.","request":{"method":"GET","url":"https://openlibrary.org/works/%7BworkId%7D.json","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"workId","at":["path:1"],"template":"{workId}.json"}],"volatile":[],"trigger":{"url":"https://openlibrary.org/works/{workId}.json"},"match":{"method":"GET","host":"openlibrary.org","path":"/works/*"},"response":{"format":"json","contentType":"application/json","extract":".","pick":["workId=key~/works/(OL\\d+W)","title","description","authorIds=authors[*].author.key","subjects","subjectPlaces=subject_places","coverId=covers[0]"]},"params":[{"name":"workId","type":"string","required":true,"description":"Open Library work id, from searchBooks","example":"OL59800W","pattern":"OL\\d+W","hint":"a work id like OL59800W"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"workId":"OL999999999W"},"expect":"input","purpose":"a work id that does not exist answers 404, read as input"}]}},{"hash":"46fe80c0f564bfc1fe54c35929613c1346f866b6c17800d85cab9a3bbea7a6ea","status":"live","confirmations":0,"registry":{"hash":"46fe80c0f564bfc1fe54c35929613c1346f866b6c17800d85cab9a3bbea7a6ea","status":"live","confirmations":0},"operation":{"name":"searchBooks","description":"Search books by title, author or subject, from the site's search page (page 1, up to 20 works): workId, title, author (list), authorId (the first author), firstPublished (\"First published in 1969\") and editions (\"92 editions\").","request":{"method":"GET","url":"https://openlibrary.org/search?q=%7Bq%7D&mode=everything","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"q","at":["query:q"]}],"volatile":[],"trigger":{"url":"https://openlibrary.org/search?q={q}&mode=everything"},"match":{"method":"GET","host":"openlibrary.org","path":"/search"},"response":{"format":"html","contentType":"text/html; charset=utf-8","pick":["workId=url~/works/(OL\\d+W)","title","author","authorId=authorUrl~/authors/(OL\\d+A)","firstPublished","editions"],"html":{"items":"ul.list-books li.searchResultItem","fields":{"title":"a.results","url":"a.results@href","author":"all:span.bookauthor a","authorUrl":"span.bookauthor a@href","firstPublished":"span.resultDetails span","editions":"span.resultDetails a"},"empty":"p.search-no-direct-match__message"}},"params":[{"name":"q","type":"string","required":true,"description":"title, author or subject words","example":"the left hand of darkness"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"q":"zzqqxxwvnothingmatch"},"expect":"empty","purpose":"a query nothing matches reads as an empty list"}],"links":[{"from":"workId","to":{"op":"getWork","arg":"workId"}},{"from":"authorId","to":{"op":"getAuthor","arg":"authorId"}}]}}]}