# Web URL & HTML Distillation with BM25 Budget Control

> Web URL & HTML Distillation with BM25 Budget Control is a paid API for AI agents from json-repair.agentdiet.dev, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-21).

Fetches and compresses a webpage URL or raw HTML into compact, agent-ready tokens using configurable distillation modes including BM25 budget-capped excerpt extraction.

## Facts

- Endpoint: GET https://json-repair.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: json-repair.agentdiet.dev
- Website: https://json-repair.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/json-repair-agentdiet-dev-web-url-html-distillation-with-bm25-budget-5a7a09ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oG-dUaWNZlHgyMLWioYH7

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 json-repair-agentdiet-dev-web-url-html-distillation-with-bm25-budget-5a7a09ad
```

Example prompt: Distill https://stripe.com/docs/payments into compact markdown using budget mode, focused on 'payment intents', and keep it under 300 tokens.

## When to prefer this

Choose this endpoint when you need to reduce a webpage or HTML blob to a minimal token footprint before injecting into an LLM prompt — especially when you have a strict token budget (use mode=budget with a BM25 query and max_tokens), want structured table/metadata extraction, or need skeleton outlines for navigation. Prefer this over generic scrapers when token cost savings and ROI proof metrics matter to your workflow.

## Known failure modes

- Missing required 'url' parameter returns validation error
- Unreachable or blocked URL results in fetch failure
- mode=budget without 'query' parameter may yield unfocused results
- max_tokens below minimum of 20 is rejected
- Invalid URL format causes parse error
- Payment not included or rejected returns HTTP 402
- HTML too large may exceed processing limits

## How this service works

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

## Output

Returns a JSON object containing distilled content in the requested format (Markdown, structured JSON tables/metadata, skeleton outline, or BM25 budget excerpt), along with ROI proof metrics showing raw token count, tokens saved, compression ratio percentage, distilled token count, and estimated LLM cost saved in USD. Also includes cache status (HIT/MISS) and billing information.

## 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/json-repair-agentdiet-dev-web-url-html-distillation-with-bm25-budget-5a7a09ad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from json-repair.agentdiet.dev](https://www.zero.xyz/host/json-repair.agentdiet.dev/llms.txt)
