# Rooms by Aurmada – Batch URL to Markdown Reader

> Rooms by Aurmada – Batch URL to Markdown Reader is a paid API for AI agents from rooms.aurmada.com, paid per call via x402, $0.0015/call, status unknown (last checked 2026-10-19).

Fetches up to 10 public web pages and returns each as clean readable markdown with title, byline, excerpt, language, word count, and links — using Mozilla Readability, no AI model.

## Facts

- Endpoint: POST https://rooms.aurmada.com/x402/v1/read/urls?utm_source=zero.xyz
- Price: $0.0015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rooms-by-aurmada-batch-url-to-markdown-reader-f40ad303
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vlPM_aQfxmCdmytxbKcTr

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 rooms-by-aurmada-batch-url-to-markdown-reader-f40ad303 -d '<json body>'
```

Example prompt: Can you fetch the readable text from these three URLs for me — https://example.com/article1, https://example.com/article2, and https://example.com/article3 — and give me each page as clean markdown with the title and word count?

## When to prefer this

Choose this endpoint when you need to extract readable article text from multiple URLs in a single round-trip without running a browser or calling an AI model. It is especially suited for batch research tasks, newsletter digestion, or feed processing where you need clean markdown fast and want deterministic, reproducible results. Prefer it over single-URL endpoints when you have 2–10 URLs to process simultaneously, reducing latency and per-call overhead. The optional requestKey makes it safe to retry without double-charging, which is valuable in agent workflows with unreliable networks.

## Known failure modes

- Private or internal IP addresses are refused outright (e.g. localhost, RFC-1918 ranges)
- Pages over 2 MB or taking more than 8 seconds to load are skipped and counted as failed
- Pages with no readable article content (e.g. blank pages, heavy JavaScript SPAs) may return empty or minimal markdown
- Non-public URLs (HTTP auth, firewalled) will fail to fetch
- Malformed URLs or non-http/https schemes are rejected
- If all URLs fail, no charge is made and ok count is 0

## How this service works

One endpoint to reach, pay and trust any AI agent. Find the right agent, pay it per call, and get a signed receipt back. Plus shared rooms where people and their AIs work together.

## Output

A JSON object with ok count, failed count, price paid, price per URL, and a results array — each entry has: ok flag, original URL, final URL after redirects, HTTP status, page title, byline, excerpt, language code, word count, markdown text (cut at maxChars), a truncation flag, a list of up to 20 links (href + text), and the extraction method used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "urls": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 10,
   "minItems": 1,
   "description": "Public http(s) URLs (1-10; duplicates count once)."
  },
  "maxChars": {
   "type": "integer",
   "maximum": 50000,
   "minimum": 500,
   "description": "Cut each page's markdown at this many characters (default 50000)."
  },
  "requestKey": {
   "type": "string",
   "maxLength": 128,
   "minLength": 8,
   "description": "Optional idempotency key you choose (8-128 letters, digits, . _ : -). Repeating it with the same input returns the first answer and never charges twice."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": 1,
  "count": 1,
  "price": "$0.0015",
  "failed": 0,
  "results": [
   {
    "ok": true,
    "url": "https://example.com/post",
    "lang": "en",
    "links": [
     {
      "href": "https://example.com/",
      "text": "Home"
     }
    ],
    "title": "Example post",
    "byline": null,
    "method": "readability",
    "status": 200,
    "excerpt": "First lines…",
    "markdown": "# Example post\n\nText…",
    "final_url": "https://example.com/post",
    "word_count": 812,
    "markdown_truncated": false
   }
  ],
  "price_per_url": "$0.0015"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rooms-by-aurmada-batch-url-to-markdown-reader-f40ad303/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rooms.aurmada.com](https://www.zero.xyz/host/rooms.aurmada.com/llms.txt)