# Search Books via OpenWeb Ninja

> Search Books via OpenWeb Ninja is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Search for books in real-time across Google Books with filtering by type, view availability, publication year, language, and country.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-books-data/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-search-books-via-openweb-ninja-9e9a3241
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fwVAoxzd9myM51lgGuLQ4

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 agents-openwebninja-com-search-books-via-openweb-ninja-9e9a3241
```

Example prompt: Search Google Books for good thriller novels published between 2010 and 2020 that have a preview available, and show me the first page of results in English for the US.

## When to prefer this

Use this endpoint when you need real-time book search results from Google Books with rich filtering options (document type, view type, publication year, language, country). Prefer this over static book databases when you need current availability of previews or full-view books, or when localizing results by country and language is important.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Invalid country or language code may return no results or default behavior
- Requesting a page beyond available results returns an empty data array
- Rate limiting or quota exhaustion returns a 402 or 429 error
- Very broad queries may return irrelevant results due to Google Books index coverage

## How this service works

Get real-time book search results from across the web with pagination and filtering support.

## Output

Returns an array of book records, each including a Google Books volume ID, title, subtitle (often showing authors and year), rank and position, publication year, cover image URL, Google Books page URL, view label (Preview/Full view), author names with links, and a link to other editions. Also returns the echoed request parameters and status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "number",
   "default": 1,
   "description": "Results page to return (pagination / scrolling)."
  },
  "query": {
   "type": "string",
   "example": "good thriller",
   "description": "Search query / keyword"
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "The country for which to get trends, specified as a 2-letter country code - see ISO 3166."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language to use for the results, specified as a 2-letter language code (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)."
  },
  "view_type": {
   "enum": [
    "any",
    "preview_and_full_view",
    "full_view"
   ],
   "type": "string",
   "default": "any",
   "description": "Find books with a specific view type (preview / full)."
  },
  "document_type": {
   "enum": [
    "any",
    "books",
    "newspapers",
    "magazines"
   ],
   "type": "string",
   "default": "any",
   "description": "Find books of a specific type."
  },
  "publication_year_to": {
   "type": "number",
   "description": "Find books published before a specific year (e.g. 2013)."
  },
  "publication_year_from": {
   "type": "number",
   "description": "Find books published after a specific year (e.g. 1980)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "title",
     "position",
     "rank"
    ],
    "properties": {
     "id": {
      "type": "string",
      "description": "Google Books volume ID for the book."
     },
     "rank": {
      "type": "integer",
      "description": "Absolute rank across all pages returned (1-based)."
     },
     "title": {
      "type": "string",
      "description": "Title of the book."
     },
     "position": {
      "type": "integer",
      "description": "Position of the result within the page (1-based)."
     },
     "subtitle": {
      "type": "string",
      "nullable": true,
      "description": "Subtitle line shown by Google Books (typically authors and publication year)."
     },
     "view_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the Google Books page for the book."
     },
     "image_url": {
      "type": "string",
      "nullable": true,
      "description": "Cover image URL for the book."
     },
     "view_label": {
      "type": "string",
      "nullable": true,
      "description": "Label of the view available for the book (e.g. Preview, Full view). Omitted when no preview is available."
     },
     "book_authors": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name"
       ],
       "properties": {
        "url": {
         "type": "string",
         "nullable": true,
         "description": "Google Books search URL filtering by this author."
        },
        "name": {
         "type": "string",
         "description": "Author full name."
        }
       }
      },
      "nullable": true,
      "description": "Authors of the book."
     },
     "publication_year": {
      "type": "integer",
      "nullable": true,
      "description": "Year of publication."
     },
     "book_more_editions_url": {
      "type": "string",
      "nullable": true,
      "description": "URL to view other editions of the book on Google Books."
     }
    }
   },
   "description": "Array of book search results returned by the API."
  },
  "status": {
   "type": "string",
   "description": "The status of the API response"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "query": {
     "type": "string",
     "description": "The search query parameter"
    },
    "country": {
     "type": "string",
     "description": "Country
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-search-books-via-openweb-ninja-9e9a3241/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)