# Webpage Distiller with BM25 Budget Control

> Webpage Distiller with BM25 Budget Control is a paid API for AI agents from polymarket-odds.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 compact Markdown, structured JSON, outline skeleton, or BM25-focused budget excerpt with token savings metrics

## Facts

- Endpoint: POST https://polymarket-odds.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: polymarket-odds.agentdiet.dev
- Website: https://polymarket-odds.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/polymarket-odds-agentdiet-dev-webpage-distiller-with-bm25-budget-2fcbd29b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VRiF6UpKF8rHYpsWnhWPX

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 polymarket-odds-agentdiet-dev-webpage-distiller-with-bm25-budget-2fcbd29b -d '<json body>'
```

Example prompt: Fetch https://stripe.com/docs/payments and distill it into clean markdown using budget mode focused on the query 'payment intents', capped at 2000 tokens — I want to see how many tokens you saved me.

## When to prefer this

Choose this endpoint when you need to compress web content to fit inside LLM context windows, especially when you want token savings metrics (ROI proof) alongside the distilled content. It is particularly valuable when you have a specific BM25 query and want only the most relevant excerpt from a large page (budget mode), or when you need structured tables/metadata extracted from a product or documentation page. Prefer it over generic scrapers when token efficiency and cost savings are a priority for your agent pipeline.

## Known failure modes

- Invalid or unreachable URL returns fetch error with non-ok status
- HTML too large or malformed may result in truncated or empty distillation
- max_tokens set too low (below 20) triggers schema validation error
- query field ignored unless mode=budget is specified
- Rate limiting or payment failure (402) if x402 payment not attached
- Timeout on slow-loading or JavaScript-heavy pages that require rendering

## How this service works

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

## Output

Returns a 'data' object containing the distilled content (Markdown text, structured JSON tables/metadata, outline skeleton, or BM25-focused excerpt depending on mode), plus an roi_proof block showing raw token count, distilled token count, tokens saved, compression ratio percentage, LLM cost saved in USD, and ROI multiplier. Also includes 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/polymarket-odds-agentdiet-dev-webpage-distiller-with-bm25-budget-2fcbd29b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from polymarket-odds.agentdiet.dev](https://www.zero.xyz/host/polymarket-odds.agentdiet.dev/llms.txt)