# ForgeMesh Library — Sexuality & Erotica Shelf

> ForgeMesh Library — Sexuality & Erotica 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 list of up to 50 public-domain books in the Sexuality & Erotica category, including classic titles like The Romance of Lust, the Kama Sutra, and Fanny Hill, with drill-down routes for full-text retrieval.

## Facts

- Endpoint: POST https://library.forgemesh.io/sexuality-erotica
- 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/forgemesh-library-sexuality-erotica-shelf-89e5ee3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ybfN-8bVWSQgNULiuNOFB

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 forgemesh-library-sexuality-erotica-shelf-89e5ee3a -d '<json body>'
```

Example prompt: Can you pull up the list of public-domain sexuality and erotica books from the ForgeMesh library — show me up to 30 titles with links so I can read them in full?

## When to prefer this

Use this endpoint when you need a curated, pre-ranked catalog of public-domain sexuality and erotica texts specifically, particularly classic historical works like the Kama Sutra, Fanny Hill, or The Romance of Lust, without needing an API key or license. Prefer this over general book search APIs when you want a narrowly scoped, immediately accessible shelf with drill-down links for full-text reading.

## Known failure modes

- Limit parameter exceeds 50 — likely returns a validation error or is capped at 50
- Non-integer or negative limit value — may return an error or default behavior
- Service unavailable or payment rejected — HTTP error with no book list returned
- Empty result if the shelf index is temporarily unavailable

## How this service works

Curated shelf: Sexuality & Erotica — 9 public-domain books including The Romance of Lust: A classic Victorian erotic novel, The Kama Sutra of Vatsyayana
Translated From the Sanscrit in Seven Parts With Preface, Introduction and Concluding Remarks, Memoirs of Fanny Hill
A New and Genuine Edition from the Original Text (London, 1749). 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 books in the Sexuality & Erotica category (up to the requested limit, default 20, max 50), each entry including title, author, and drill-down routes for full-text retrieval.

## 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 Romance of Lust: A classic Victorian erotic novel",
    "author": "Anonymous",
    "book_id": 30254,
    "subjects": [],
    "download_count": 6156
   }
  ],
  "count": 5,
  "shelf": "Sexuality & Erotica",
  "coverage": {
   "target": 860,
   "indexed": 860
  },
  "drill_down": [
   "/book-metadata",
   "/book-chapter",
   "/book-quotes",
   "/literature-search"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-library-sexuality-erotica-shelf-89e5ee3a/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)