# Web URL / HTML Distillation with BM25 Budget Control

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

Fetches and compresses a URL or raw HTML into compact, token-efficient agent-ready content using selectable distillation modes including a BM25-focused budget mode with a strict token ceiling.

## Facts

- Endpoint: POST https://serp-extract.agentdiet.dev/v1/context-compress?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Provider: serp-extract.agentdiet.dev
- Website: https://serp-extract.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/serp-extract-agentdiet-dev-web-url-html-distillation-with-bm25-budget-f4284d8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ge_-ziUeq6wuhEfJBXxBW

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 serp-extract-agentdiet-dev-web-url-html-distillation-with-bm25-budget-f4284d8a -d '<json body>'
```

Example prompt: Distill https://stripe.com/docs/payments into compact markdown, but cap it at 800 tokens and focus the BM25 query on 'payment intents' so only the most relevant content makes it in.

## When to prefer this

Choose this endpoint when you need to reduce token usage before passing web content to an LLM, especially when working with a strict context window or cost budget. The BM25 budget mode is uniquely suited for retrieving only the most query-relevant excerpt from a long page under a hard token ceiling. Prefer it over generic scrapers when you need compression metrics (ROI proof, tokens saved) alongside the content. Use the raw HTML input option when you have already fetched the page and just need distillation without a second fetch.

## Known failure modes

- URL is unreachable or returns non-200 status — fetch error returned
- max_tokens set below minimum of 20 — validation error
- mode=budget used without providing a query — may return unfiltered or degraded output
- Raw HTML too large to process within service limits — timeout or truncation
- Invalid URL format provided — schema validation error
- Target site blocks headless fetching — empty or error content returned

## How this service works

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

## Output

Returns a JSON object containing the distilled content (Markdown, structured JSON, skeleton outline, or BM25 budget excerpt depending on mode), an ROI proof block showing raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD, plus optional cache hit/miss status and billing details.

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