# Venture Reader API — URL to Clean Markdown Extractor

> Venture Reader API — URL to Clean Markdown Extractor is a paid API for AI agents from api.venturebot.party, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches a web page by URL and returns the readable article content as clean Markdown, stripping navigation, ads, and boilerplate.

## Facts

- Endpoint: POST https://api.venturebot.party/extract
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/venture-reader-api-url-to-clean-markdown-extractor-fe56f1e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YjAfoLm6eo1b7EsoJWt0y

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 venture-reader-api-url-to-clean-markdown-extractor-fe56f1e9 -d '<json body>'
```

Example prompt: Fetch the article at https://en.wikipedia.org/wiki/Markdown and give me the main content as clean Markdown so I can use it in my prompt.

## When to prefer this

Choose this endpoint when you need to extract the readable main-body text of an article or web page as Markdown, especially for feeding into an LLM context window. It is ideal when you want clean, boilerplate-free content (no nav, ads, or footers) with minimal setup — no signup or KYC required, just a URL and optionally prepaid USDC credits. Prefer it over generic scraping tools when the output format must be Markdown and when metadata like title, byline, word count, and language are also useful.

## Known failure modes

- URL is not reachable or returns a non-200 HTTP status — extraction fails with an error response
- Page is behind a hard login wall or CAPTCHA — content cannot be extracted
- URL points to a binary file (PDF, image) rather than an HTML page — Markdown output may be empty or malformed
- Free tier credits exhausted and no USDC prepaid balance — request is rejected with a payment-required error
- Malformed or non-absolute URL provided — validation error returned
- Page has very little readable content (e.g. pure JavaScript SPA with no server-rendered text) — markdown field may be empty or minimal

## How this service works

Give it a URL, get back the readable article as Markdown. Free tier, then prepaid USDC-on-Base credits at $0.01/call. No signup, no KYC.

## Output

Returns a JSON object with: the cleaned article as Markdown (markdown field), title, excerpt, byline, site name, detected language, word count, character length, processing time in ms, and usage info (mode and calls remaining). The Markdown field is the main deliverable for LLM consumption.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "Absolute http(s) URL of the page to extract"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "ms": 812,
 "url": "https://en.wikipedia.org/wiki/Markdown",
 "lang": "en",
 "title": "Markdown",
 "usage": {
  "mode": "paid",
  "callsRemaining": 96
 },
 "words": 4120,
 "byline": null,
 "length": 28734,
 "excerpt": "Markdown is a lightweight markup language...",
 "markdown": "## History\n\nMarkdown was created in 2004 ...",
 "siteName": "Wikipedia"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/venture-reader-api-url-to-clean-markdown-extractor-fe56f1e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.venturebot.party](https://www.zero.xyz/host/api.venturebot.party/llms.txt)
