# library.forgemesh.io Adventure Fiction Shelf

> library.forgemesh.io Adventure Fiction Shelf is a paid API for AI agents from library.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns a ranked, curated list of public-domain adventure fiction books including title, author, year, book_id, and drill-down routes for full-text retrieval.

## Facts

- Endpoint: POST https://library.forgemesh.io/adventure
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/library-forgemesh-io-adventure-fiction-shelf-57d7df2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TN56R4FTnyw5hutkqWmf0

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 library-forgemesh-io-adventure-fiction-shelf-57d7df2b -d '<json body>'
```

Example prompt: Pull me the top 25 historically popular public-domain adventure novels from the library — I want the title, author, year, and the IDs so I can fetch full texts later.

## When to prefer this

Choose this endpoint when you need a quick, curated, pre-ranked index of public-domain adventure fiction without any authentication or licensing overhead. It is ideal for seeding reading lists, populating recommendation engines, or discovering book IDs needed to fetch full texts via sibling endpoints. Prefer it over general web search when you specifically want structured bibliographic metadata (title, author, year, book_id) with ready-made drill-down routes.

## Known failure modes

- limit parameter exceeds 50 — request may be rejected or clamped to the maximum
- limit set to 0 or a negative integer — may return empty list or error
- network timeout or service unavailability — no result returned
- payment not processed (x402 protocol failure) — endpoint returns 402 and no data

## How this service works

Curated shelf of public-domain adventure fiction, ranked by historical popularity. Returns title, author, year, book_id, and drill-down routes for full-text retrieval. No license, no API key required.

## Output

A ranked list of up to 50 public-domain adventure fiction books, each containing title, author name, publication year, book_id, and drill-down route URLs for fetching the full text of each book.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max books to return (default 20, max 50)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "books": [
   {
    "year": "2004",
    "title": "The Adventures of Tom Sawyer, Complete",
    "author": "Twain, Mark, 1835-1910",
    "book_id": 74,
    "subjects": [
     "Adventure stories"
    ],
    "download_count": 14288
   }
  ],
  "count": 5,
  "shelf": "Adventure",
  "coverage": {
   "target": 1000,
   "indexed": 865
  },
  "drill_down": [
   "/book-metadata",
   "/book-chapter",
   "/book-quotes",
   "/literature-search"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/library-forgemesh-io-adventure-fiction-shelf-57d7df2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from library.forgemesh.io](https://www.zero.xyz/host/library.forgemesh.io/llms.txt)