{"uid":"cap_-DxzmLNndTr2bXhEM9EUU","slug":"book-bot-app-8bb1c3aa","name":"book-bot.app Book Search","description":"Search Anna's Archive for matching books. Returns up to 10 result entries with URLs that can be passed to /api/books/download-link.","url":"https://book-bot.app/api/books/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"author":{"type":"string","description":"The author of the book (optional)."},"bookName":{"type":"string","minLength":1,"description":"The title of the book to search for."}}},"responseSchema":{"type":"json","example":{"books":[{"url":"https://annas-archive.org/md5/abc123","title":"1984","author":"George Orwell","details":"epub · 1.2 MB · 1949","thumbnail":"https://example.com/cover.jpg"}]}},"example":{"request":{"author":"F. Scott Fitzgerald","bookName":"The Great Gatsby"},"response":{"books":[{"url":"https://annas-archive.gl/md5/42bd6cefee31d13b80746b19d98da5fa","title":"The Great Gatsby","author":"Fitzgerald, Francis Scott","details":"EPUB · 0.2MB · 2011","thumbnail":"https://covers.z-lib.sk/covers400/collections/foreignfiction/9ad26df74b9486d8af5ad7bd59eb4e98285a38845a1934ca43d25c4c7a1e2faf.jpg"},{"url":"https://annas-archive.gl/md5/ccdc673b444d4f74d5478714ce6825c3","title":"The Great Gatsby","author":"F. Scott Fitzgerald","details":"EPUB · 0.3MB · 2021","thumbnail":""},{"url":"https://annas-archive.gl/md5/a7b18fde09981633c83184404ea8796f","title":"The Great Gatsby","author":"F. Scott Fitzgerald","details":"EPUB · 0.4MB · 2021","thumbnail":"https://covers.z-lib.sk/covers400/collections/userbooks/c3612bce967960fd4ddced455af678c0c174fa9f557decaf64f08f24f9428491.jpg"},{"url":"https://annas-archive.gl/md5/4b38ad7679d0d732195ad180d49e2a84","title":"The Great Gatsby","author":"F. Scott Fitzgerald [Fitzgerald, F. Scott]","details":"EPUB · 0.2MB · 1925","thumbnail":"https://covers.z-lib.sk/covers400/collections/userbooks/e8c6aad59ff300a1216ecd3afa0b7e9c64080c2f359f427995f1511b1c3a23be.jpg"},{"url":"https://annas-archive.gl/md5/6a76c59deae330217799bf9112bb66ed","title":"The Great Gatsby","author":"F. Scott Fitzgerald","details":"EPUB · 0.2MB · 2011","thumbnail":"https://covers.z-lib.sk/covers400/collections/userbooks/eae341420de4b2354c1e4e959a9f5078eba4a052b82b799ed40f4728570a407d.jpg"},{"url":"https://annas-archive.gl/md5/e366f1a691a8ed57a0cc6fde79fb85de","title":"The Great Gatsby","author":"F. Scott Fitzgerald","details":"EPUB · 0.7MB · N/A","thumbnail":"https://covers.z-lib.sk/covers400/collections/userbooks/b8f285707ae6c62ec2e72c30d3e75b35860177adf5bbae6cbeb756d513b75ab8.jpg"},{"url":"https://annas-archive.gl/md5/74079a1f2bde0a2b18aab8047ab39713","title":"The Great Gatsby","author":"F. Scott Fitzgerald","details":"EPUB · 0.4MB · 1925","thumbnail":"https://covers.z-lib.sk/covers400/collections/userbooks/9a0f220afe8baed29d741a6ba3c2f9658d1a561d57cf2b51d381ee1c527e6aff.jpg"},{"url":"https://annas-archive.gl/md5/a8f5d441287951a446c0ad65fa4fee61","title":"The Great Gatsby","author":"F. Scott Fitzgerald [Fitzgerald, F. Scott]","details":"EPUB · 0.4MB · 1925","thumbnail":"https://covers.z-lib.sk/covers400/collections/userbooks/76b460bc2bcc08f01819962425a7206535574c06536dd81be7666b677ea015f2.jpg"},{"url":"https://annas-archive.gl/md5/be7988e316e204d63b607c4e3e962d0c","title":"The Great Gatsby","author":"F. Scott Fitzgerald [F. Scott Fitzgerald]","details":"EPUB · 0.2MB · 2012","thumbnail":"https://covers.z-lib.sk/covers400/collections/userbooks/a1923167e882992295b036d499fb55980fed674c3d1c3154b1210afe1dcd50ae.png"},{"url":"https://annas-archive.gl/md5/0d23d325b4a997d49aadaabb05f8f544","title":"The Great Gatsby","author":"F. Scott Fitzgerald","details":"EPUB · 0.2MB · 2014","thumbnail":"https://covers.z-lib.sk/covers400/collections/genesis/5eb3f778ea0a64ab92f1cfc4bd2088465534bc870c304a795b2c96e52f5a3903.jpg"}]}},"exampleRequest":{"author":"F. Scott Fitzgerald","bookName":"The Great Gatsby"},"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oMY2aMDnon9rRTziQ10rK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Anna's Archive for books matching a query and returns up to 10 result entries with URLs usable for EPUB download link resolution.","exampleAgentPrompt":"Search Anna's Archive for 'Dune' by Frank Herbert and give me a list of matching results I can use to download the EPUB.","exampleUseCases":null,"resultDescription":"Returns up to 10 book result entries, each containing metadata about the matched book and an Anna's Archive result page URL that can be passed to the /api/books/download-link endpoint to obtain a direct EPUB download URL.","failureModes":["No results found for the given search query","Search query too vague or ambiguous, returns unrelated books","Anna's Archive unavailable or rate-limited, causing timeout","Malformed request body returns 400 error","Payment not processed correctly, returns 402 error"],"whenToPreferThis":"Use this endpoint when you need to discover and identify books available on Anna's Archive before attempting a download. This is the first step in a two-step flow: search here to get result URLs, then pass those URLs to /api/books/download-link to get a direct EPUB download URL. Prefer this over the combined /api/books endpoint when you want to inspect or select from multiple matching results before committing to a download.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:25.447Z","isFirstParty":false}