# library.forgemesh.io Periodicals Shelf

> library.forgemesh.io Periodicals 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-16).

Returns a ranked list of up to 274 public-domain periodicals (journals, reviews, and magazines) with drill-down routes for full-text retrieval

## Facts

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

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-periodicals-shelf-9fbd9259 -d '<json body>'
```

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

## When to prefer this

Choose this endpoint when you need to browse or catalog public-domain periodicals specifically (journals, reviews, magazines) rather than books in other genres. Use it over the full-text search endpoint when you want a curated ranked list of titles rather than passage-level results. Prefer this over general web search when you need structured, drill-down-ready metadata for historical periodicals without licensing concerns.

## Known failure modes

- Payment failure (x402 protocol): call rejected if USDC payment of $0.003 is not provided
- Limit out of range: values above 50 may be clamped or return an error
- Empty result: unlikely given 274 items in shelf, but possible if index is unavailable
- Network/server error: endpoint unreachable or returns 5xx

## How this service works

Curated shelf: Periodicals — 274 public-domain books including Chambers's Edinburgh Journal, No. 452 Volume 18, New Series, August 28, 1852, Chambers's Journal of Popular Literature, Science, and Art, fifth series, no. 153, vol. III, December 4, 1886, The Quarterly Review, Volume 162, No. 324, April, 1886. Returns a ranked list with drill-down routes for full-text retrieval. No license, no API key required.

## Output

A ranked list of public-domain periodicals (up to the requested limit, default 20, max 50), including titles such as Chambers's Edinburgh Journal, Chambers's Journal of Popular Literature, Science, and Art, and The Quarterly Review, along with drill-down routes that can be used for full-text retrieval of each title.

## 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": "Chambers's Edinburgh Journal, No. 452 Volume 18, New Series, August 28, 1852",
    "author": "Various",
    "book_id": 22187,
    "subjects": [],
    "download_count": 35483
   }
  ],
  "count": 5,
  "shelf": "Periodicals",
  "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-periodicals-shelf-9fbd9259/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)