# x402broker Markdown Distill — HTML-to-Markdown Semantic Distillation

> x402broker Markdown Distill — HTML-to-Markdown Semantic Distillation is a paid API for AI agents from x402broker.com, paid per call via x402 or MPP, $0.001/call, status unknown (last checked 2026-10-20).

Fetches a URL and strips 85–97% of HTML token bloat, returning clean semantic markdown for LLM consumption

## Facts

- Endpoint: GET https://x402broker.com/v1/markdown-distill?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402broker-markdown-distill-html-to-markdown-semantic-distillation-facb0ba9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sYdh1ztHuql8qtGPp9sQj

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 x402broker-markdown-distill-html-to-markdown-semantic-distillation-facb0ba9
```

Example prompt: Can you fetch https://en.wikipedia.org/wiki/Artificial_intelligence and distill it down to clean markdown — strip all the HTML bloat so I can feed just the meaningful content to my LLM without burning through tokens?

## When to prefer this

Choose this endpoint when you need to feed webpage content into an LLM and want to minimize token usage by removing HTML structure, navigation, ads, and boilerplate. It is ideal for agent pipelines that need to ingest multiple URLs efficiently, for RAG ingestion workflows, or any scenario where raw HTML would waste significant context window space. Prefer this over raw fetch-and-parse approaches when you want semantic distillation rather than just tag stripping.

## Known failure modes

- URL is unreachable or returns a non-200 status — endpoint may return an error or empty content
- JavaScript-rendered single-page applications may yield minimal content since the distiller fetches raw HTML
- Paywalled or bot-protected pages may return access-denied content rather than the article body
- Extremely large pages may hit processing limits or timeout
- Invalid or malformed URL input causes request failure

## How this service works

Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://x402broker.com/v1/markdown-distill)

## Output

Returns clean, semantic markdown text representing the core content of the fetched URL, with 85–97% of HTML token bloat removed — including navigation, ads, boilerplate, and structural tags — leaving only meaningful textual content suitable for LLM ingestion.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "minLength": 1,
   "description": "Target webpage URL to fetch and distill (or builtin://stripe-docs)"
  },
  "html": {
   "type": "string",
   "description": "Optional raw HTML string to distill directly without fetching"
  },
  "mode": {
   "enum": [
    "markdown",
    "structured",
    "skeleton",
    "budget"
   ],
   "type": "string",
   "default": "markdown",
   "description": "Distillation mode"
  },
  "query": {
   "type": "string",
   "description": "BM25 focus query when mode=budget"
  },
  "max_tokens": {
   "type": "integer",
   "minimum": 20,
   "description": "Strict token budget ceiling when mode=budget"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "roi_proof",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "description": "Distilled Markdown, structured JSON tables/metadata, skeleton outline, or BM25 budget excerpt."
  },
  "cache": {
   "type": "object",
   "properties": {
    "status": {
     "enum": [
      "HIT",
      "MISS"
     ],
     "type": "string"
    },
    "cache_key": {
     "type": "string"
    },
    "latency_ms": {
     "type": "number"
    }
   }
  },
  "status": {
   "type": "string",
   "description": "Execution status ('ok')"
  },
  "billing": {
   "type": "object",
   "properties": {
    "agent_id": {
     "type": "string"
    },
    "payment_method": {
     "type": "string"
    },
    "fee_charged_usd": {
     "type": "number"
    }
   }
  },
  "roi_proof": {
   "type": "object",
   "properties": {
    "raw_tokens": {
     "type": "integer"
    },
    "tokens_saved": {
     "type": "integer"
    },
    "roi_multiplier": {
     "type": "number"
    },
    "distilled_tokens": {
     "type": "integer"
    },
    "llm_cost_saved_usd": {
     "type": "number"
    },
    "compression_ratio_pct": {
     "type": "number"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402broker-markdown-distill-html-to-markdown-semantic-distillation-facb0ba9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402broker.com](https://www.zero.xyz/host/x402broker.com/llms.txt)