# library.forgemesh.io Poetry Shelf

> library.forgemesh.io Poetry 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-15).

Returns a ranked list of public-domain poetry collections with title, author, year, book ID, and drill-down routes for full-text retrieval.

## Facts

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

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-poetry-shelf-dea751f4 -d '<json body>'
```

Example prompt: Can you pull up a list of the top 20 most popular public-domain poetry collections available on the forgemesh library — I want the titles, authors, and years so I can pick one to explore?

## When to prefer this

Choose this endpoint when you need a curated, ranked catalog of public-domain poetry books with identifiers that enable further full-text retrieval. It is ideal for discovery workflows where you want to browse available poetry titles before drilling into individual poems. Prefer this over general web search when you need structured, machine-readable metadata (title, author, year, book_id) rather than raw HTML pages.

## Known failure modes

- limit exceeds maximum of 50 — API may return an error or cap silently at 50
- network or payment failure via x402 protocol results in no response
- empty result set if the indexed poetry corpus is unavailable or being reindexed
- malformed request body returns a validation error

## How this service works

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

## Output

A ranked list of public-domain poetry collections, each including the book title, author name, publication year, a unique book_id, and drill-down routes that can be used to retrieve individual poems or passages from that collection.

## 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": "1998",
    "title": "The Raven",
    "author": "Poe, Edgar Allan, 1809-1849",
    "book_id": 1065,
    "subjects": [
     "American poetry"
    ],
    "download_count": 8000
   }
  ],
  "count": 5,
  "shelf": "Poetry",
  "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-poetry-shelf-dea751f4/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)