# AgentDiet HTML to Markdown Converter

> AgentDiet HTML to Markdown Converter is a paid API for AI agents from agentdiet.dev, paid per call via x402 or MPP, $0.001/call, status unknown (last checked 2026-10-20).

Converts a web page's HTML into clean Markdown by stripping 85-97% of token bloat, making content LLM-ready

## Facts

- Endpoint: GET https://agentdiet.dev/v1/html-to-markdown?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/agentdiet-html-to-markdown-converter-df8fe376
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XUJVolElZA-L1HGDI_Tv8

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 agentdiet-html-to-markdown-converter-df8fe376
```

Example prompt: Can you fetch https://en.wikipedia.org/wiki/Large_language_model and convert it to clean Markdown, stripping all the HTML bloat so I can use it in my LLM prompt?

## When to prefer this

Choose this endpoint when you need to fetch a live web page and immediately get a token-efficient, LLM-ready Markdown representation of its content. It is ideal for AI agent pipelines that must ingest web content without blowing up context windows, compared to raw HTML scraping or full browser automation tools. Prefer it over generic HTML scrapers when token reduction and semantic distillation quality matter.

## Known failure modes

- URL is unreachable or returns a non-200 status — endpoint may return an error or empty content
- Dynamic JavaScript-rendered pages may not be fully captured since the fetch is likely static HTML only
- Very large pages may be truncated or slow to process
- Paywalled or login-protected pages will return minimal or no content
- Invalid or malformed URL input causes a bad request error

## How this service works

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

## Output

Returns the fetched web page's content as clean Markdown with navigation, scripts, ads, and HTML markup stripped out, reducing token count by 85-97% compared to raw HTML — ideal for feeding into LLM context windows or downstream text processing pipelines.

## 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/agentdiet-html-to-markdown-converter-df8fe376/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdiet.dev](https://www.zero.xyz/host/agentdiet.dev/llms.txt)