# Webpage Distiller with BM25 Budget Control

> Webpage Distiller 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 distills a URL or raw HTML into Markdown, structured JSON, a skeleton outline, or a BM25-ranked token-budget excerpt

## Facts

- Endpoint: POST https://serp-extract.agentdiet.dev/v1/webpage-distiller?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-webpage-distiller-with-bm25-budget-control-fea33bd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4ZHLX0A07WuD8BMQ0vdnb

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-webpage-distiller-with-bm25-budget-control-fea33bd0 -d '<json body>'
```

Example prompt: Can you distill this URL into clean markdown and keep it under 800 tokens, focused on anything about pricing? https://example.com/product — use budget mode with that token ceiling.

## When to prefer this

Choose this endpoint when you need to reduce LLM context costs by compressing webpage content before passing it to a model, especially when you have a token budget constraint or a specific BM25 focus query. It is superior to raw scraping when you need clean Markdown, structured JSON, or a skeleton outline rather than raw HTML. The ROI proof output makes it ideal for agents that need to justify token savings. Prefer it over generic scraping APIs when you want built-in compression metrics and BM25-ranked relevance filtering.

## Known failure modes

- URL is unreachable or returns non-200 — fetch failure error
- HTML payload is empty or malformed — parsing error
- mode=budget used without a query parameter — missing required field error
- max_tokens set below minimum of 20 — validation error
- Rate limit or payment failure via x402 — 402 Payment Required
- Target page is JavaScript-rendered and content is not in static HTML — empty or incomplete distillation
- Idempotency-Key collision on a different payload — conflict 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://serp-extract.agentdiet.dev/v1/webpage-distiller)

## Output

Returns a JSON object with a 'data' field containing the distilled content (Markdown text, structured JSON with tables/metadata, a skeleton outline, or a BM25-ranked excerpt), plus an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and llm_cost_saved_usd. Also includes cache status (HIT/MISS) 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-webpage-distiller-with-bm25-budget-control-fea33bd0/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)