# Web URL Prompt Compression & Distillation API

> Web URL Prompt Compression & Distillation API is a paid API for AI agents from llms-generator.agentdiet.dev, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-21).

Fetches a webpage or raw HTML and compresses it into compact, agent-ready tokens using BM25 budget control and multiple distillation modes

## Facts

- Endpoint: GET https://llms-generator.agentdiet.dev/v1/prompt-compress?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Provider: llms-generator.agentdiet.dev
- Website: https://llms-generator.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/llms-generator-agentdiet-dev-web-url-prompt-compression-distillation-34dced41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dxTUjlQ9kJYsYlIffSrmM

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 llms-generator-agentdiet-dev-web-url-prompt-compression-distillation-34dced41
```

Example prompt: Can you fetch the Stripe pricing page and compress it into markdown using budget mode, keeping it under 500 tokens and focusing on the query 'subscription pricing'?

## When to prefer this

Choose this endpoint when you need to fit web content into a constrained LLM context window and want measurable token savings with ROI proof. Especially useful when working with large documentation pages, research articles, or any URL where raw content would exceed your token budget. The BM25 budget mode makes it superior to generic scrapers when you have a specific focus query. Prefer this over generic web scrapers when you need structured, LLM-optimized output rather than raw HTML.

## Known failure modes

- Invalid or unreachable URL returns error status
- HTML too large or unparseable may return partial results
- mode=budget without a query may produce suboptimal BM25 results
- max_tokens below minimum of 20 returns validation error
- Rate limiting or payment failure (HTTP 402) if USDC payment not provided
- Timeout if target URL is slow to respond

## How this service works

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

## Output

Returns a JSON object with a 'data' field containing the distilled content (markdown, structured JSON, skeleton outline, or BM25 excerpt depending on mode), plus an 'roi_proof' object showing raw vs. distilled token counts, compression ratio percentage, tokens saved, ROI multiplier, and estimated LLM cost saved in USD. Also includes optional billing and cache metadata.

## 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/llms-generator-agentdiet-dev-web-url-prompt-compression-distillation-34dced41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from llms-generator.agentdiet.dev](https://www.zero.xyz/host/llms-generator.agentdiet.dev/llms.txt)