{"uid":"cap_xdGCYmHqQujucQMhOkvr9","slug":"email-verify-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-a0e5db2e","name":"Web URL to Markdown Distiller with BM25 Budget Control","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://email-verify.agentdiet.dev/v1/url-to-markdown)","url":"https://email-verify.agentdiet.dev/v1/url-to-markdown?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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"}}}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.001","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7bh1-se71scptUpScz-XZ","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"email-verify.agentdiet.dev","brandSlug":"email-verify-agentdiet-dev-mpp","brandBaseUrl":"https://email-verify.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a webpage or raw HTML and distills it into compact, agent-ready Markdown, structured JSON, skeleton outline, or BM25-focused budget excerpt with token-savings reporting","exampleAgentPrompt":"Fetch https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 1000 tokens and focusing the BM25 query on 'payment intents'.","exampleUseCases":[{"title":"Token-budget research before LLM call","prompt":"I need to pull the content from https://openai.com/pricing and distill it into budget mode focused on 'GPT-4 cost per token', with a strict ceiling of 500 tokens so I don't blow my context window."},{"title":"Structured data extraction from a product page","prompt":"Grab https://www.apple.com/shop/product/MKGQ3LL/A and convert it to structured mode so I get the tables and metadata as JSON instead of raw HTML."},{"title":"Quick skeleton outline of documentation page","prompt":"Can you distill https://docs.anthropic.com/en/docs/intro into skeleton mode so I get just the headings and outline without all the body text?"}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt depending on mode), plus an 'roi_proof' object showing raw token count, distilled token count, tokens saved, compression ratio percentage, ROI multiplier, and estimated LLM cost saved in USD. Also includes optional cache hit/miss status and billing details.","failureModes":["Invalid or unreachable URL returns an error status","max_tokens below minimum of 20 rejected with validation error","Mode set to 'budget' without a query or max_tokens may return unfiltered content","Private or paywalled URLs may return empty or partial content","Malformed HTML input may produce garbled markdown output","Rate limits or payment failures via x402 may block the request"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to ingest a webpage but wants to minimize token consumption before passing content to an LLM. It is especially useful when you need BM25-focused relevance filtering against a specific query within a strict token budget, when you want structured JSON extraction from HTML tables, or when you need a clean skeleton outline of a long document. Prefer this over raw HTTP fetches when token cost and compression quality matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:25:36.023Z","isFirstParty":false,"canonicalSlug":"email-verify-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-8fdc3fc6"}