# library.forgemesh.io Journals Shelf

> library.forgemesh.io Journals 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-13).

Returns a ranked, pageable list of up to 1,421 public-domain journal titles with drill-down routes for full-text retrieval

## Facts

- Endpoint: POST https://library.forgemesh.io/journals
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/library-forgemesh-io-journals-shelf-00eabc3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y_7TvsjH0jCzFx-5Q6uQv

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-journals-shelf-00eabc3e -d '<json body>'
```

Example prompt: Can you show me a list of public-domain journals available in the library — give me up to 30 results with links so I can drill into any of them for the full text?

## When to prefer this

Choose this endpoint when you need a curated, browsable list of public-domain journals specifically, rather than performing a full-text keyword search across all genres. Prefer this over the full-text search endpoint when the user wants to discover or browse journal titles rather than find specific passages. Prefer over other shelf endpoints when the target material is periodicals, academic journals, or serial publications rather than novels, classics, or children's literature.

## Known failure modes

- limit parameter exceeds max of 50 — API may reject or cap results
- Payment failure via x402 protocol — call returns 402 if USDC payment is not processed
- Malformed request body — server returns 400 if JSON is invalid
- Service unavailable — 503 if library backend is down
- Empty result — shelf may return zero results if corpus is temporarily unavailable

## How this service works

Curated shelf: Journals — 1421 public-domain books including The Journal of Negro History, Volume 6, 1921, Chambers's Journal of Popular Literature, Science, and Art, fifth series, no. 153, vol. III, December 4, 1886, The Journal of Negro History, Volume 3, 1918. Returns a ranked list with drill-down routes for full-text retrieval. No license, no API key required.

## Output

A ranked list of journal titles (up to 50) drawn from 1,421 public-domain journals, each accompanied by drill-down routes that allow retrieval of full text. Titles include historical periodicals like The Journal of Negro History and Chambers's Journal of Popular Literature, Science, and Art.

## 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": null,
    "title": "The Journal of Negro History, Volume 6, 1921",
    "author": "Various",
    "book_id": 22149,
    "subjects": [],
    "download_count": 10987
   }
  ],
  "count": 5,
  "shelf": "Journals",
  "coverage": {
   "target": 61015,
   "indexed": 61015
  },
  "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-journals-shelf-00eabc3e/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)