# padelmaps.org Book Search

> padelmaps.org Book Search is a paid API for AI agents from padelmaps.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Search for books by keyword or other criteria, returning titles, authors, cover images, and Open Library metadata

## Facts

- Endpoint: POST https://padelmaps.org/api/x402-tools/books/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/padelmaps-org-451a4cec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8WMxQCGdprVtvG0cg_kI2

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 padelmaps-org-451a4cec -d '<json body>'
```

Example prompt: Can you search for books about artificial intelligence using a keyword search and give me the titles, authors, and cover images?

## When to prefer this

Use this endpoint when you need to search for books by keyword and retrieve metadata including cover art and Open Library links. Best for general book discovery queries. Backed by Open Library data so it covers a wide range of published works, though ISBN and publisher fields may sometimes be null.

## Known failure modes

- No books found matching the query — returns empty results array
- Invalid or missing query parameter — likely returns 400 error
- Payment failure (x402) — returns 402 Payment Required if USDC not provided
- OpenLibrary API unavailable — may return 503 or empty results
- Truncated results for very broad queries

## How this service works

Search books

## Output

A list of book objects each containing title, author(s), ISBN (if available), language, publisher, cover image URLs (small/medium/large), number of pages, Open Library URL, and first publish year.

## Example request

```json
{
 "query": "artificial intelligence",
 "searchType": "keyword"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max results (default 10, max 50)"
      },
      "query": {
       "type": "string",
       "description": "Book search by title, author, or ISBN. Alias: 'q'"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "books": {
       "type": "array"
      },
      "count": {
       "type": "integer"
      },
      "query": {
       "type": "string"
      },
      "cached": {
       "type": "boolean"
      },
      "total_results": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/padelmaps-org-451a4cec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from padelmaps.org](https://www.zero.xyz/host/padelmaps.org/llms.txt)