# Rotary Agency PoetryDB API

> Rotary Agency PoetryDB API is a paid API for AI agents from rotaryagency.uk, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Proxies the PoetryDB public poetry database, returning structured JSON with poems, authors, titles, and lines from classic poetry collections.

## Facts

- Endpoint: GET https://rotaryagency.uk/api/free/poetrydb
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rotary-agency-poetrydb-api-a0908501
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZLIiAL-B9O36JTe0rjpID

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 rotary-agency-poetrydb-api-a0908501
```

Example prompt: Can you find me all poems by Emily Dickinson from the PoetryDB database and show me the full text of a few?

## When to prefer this

Choose this endpoint when you need free, structured, machine-readable access to classic/public-domain poetry and want to search or filter by author, title, or line count. Prefer it over scraping poetry websites when you need clean JSON output suitable for downstream processing. The $0.002/call cost via x402 makes it suitable for high-frequency or automated poetry retrieval tasks.

## Known failure modes

- Author or title not found returns an empty result or 404-style JSON response
- Misspelled author/title names yield no results
- PoetryDB upstream outage causes downstream failure
- Overly broad queries may return very large response payloads
- Rate limiting or payment failure at the x402 layer prevents access

## How this service works

Free-source data APIs (100% margin, no proxy, $0.002/call): ...

## Output

Returns structured JSON containing poem metadata and content, including fields such as title, author, lines (array of strings), and linecount. Results vary by query type — may return a list of poems, a single poem, or a list of matching titles/authors depending on the search parameters used.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "varies": "endpoint-specific structured JSON"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rotary-agency-poetrydb-api-a0908501/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rotaryagency.uk](https://www.zero.xyz/host/rotaryagency.uk/llms.txt)