# book-bot.app Book Search

> book-bot.app Book Search is a paid API for AI agents from book-bot.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Searches Anna's Archive for books matching a query and returns up to 10 result entries with URLs usable for EPUB download link resolution.

## Facts

- Endpoint: POST https://book-bot.app/api/books/search
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/book-bot-app-8bb1c3aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-DxzmLNndTr2bXhEM9EUU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability book-bot-app-8bb1c3aa -d '<json body>'
```

Example prompt: Search Anna's Archive for 'Dune' by Frank Herbert and give me a list of matching results I can use to download the EPUB.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Search Anna's Archive for matching books. Returns up to 10 result entries with URLs that can be passed to /api/books/download-link.

## Output

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.

## Example request

```json
{
 "author": "F. Scott Fitzgerald",
 "bookName": "The Great Gatsby"
}
```

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/book-bot-app-8bb1c3aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from book-bot.app](https://www.zero.xyz/host/book-bot.app/llms.txt)