{"uid":"cap_gPqhWeeVZ3AD8znNkgWSl","slug":"serp-extract-agentdiet-dev-url-html-bm25-budget-distillation-api-9db06459","name":"URL & HTML BM25 Budget Distillation API","description":"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/markdown-distill)","url":"https://serp-extract.agentdiet.dev/v1/markdown-distill?utm_source=zero.xyz","method":"POST","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_--qWfwdPsyp_uNXPQpc2X","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"serp-extract.agentdiet.dev","brandSlug":"serp-extract-agentdiet-dev-mpp","brandBaseUrl":"https://serp-extract.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or accepts raw HTML and distills it into compact, token-budgeted Markdown using BM25 relevance scoring to maximize signal-to-noise ratio for agents.","exampleAgentPrompt":"Distill the content at https://stripe.com/docs/payments into compact Markdown using budget mode, focusing on 'payment intents setup', and keep it under 500 tokens.","exampleUseCases":[{"title":"Token-efficient doc fetching for LLM context","prompt":"Grab the content from https://docs.python.org/3/library/asyncio.html and distill it in budget mode focused on 'event loop usage', capped at 300 tokens — I want just the relevant bits without blowing my context window."},{"title":"Competitor pricing page analysis","prompt":"Fetch https://www.notion.so/pricing and distill it into structured mode so I can extract the pricing tiers and feature comparison tables cleanly."},{"title":"Summarize raw HTML email content","prompt":"I have a raw HTML string from a newsletter — can you distill it into clean Markdown skeleton mode so I can see just the headings and key structure without all the noise?"}],"resultDescription":"Returns a JSON object containing: distilled content (Markdown, structured JSON, skeleton outline, or BM25 excerpt depending on mode), an ROI proof block showing raw vs distilled token counts, compression ratio, and estimated LLM cost saved, plus billing details and cache hit/miss status.","failureModes":["URL is unreachable or returns non-200 — fetch fails with error status","HTML input is malformed or empty — distillation returns minimal or empty output","max_tokens too low to capture any meaningful content — may return truncated or empty excerpt","BM25 query not specific enough — budget mode returns low-relevance content","Rate limit or payment failure via x402 — request rejected with 402 Payment Required","Invalid mode enum value — API returns validation error"],"whenToPreferThis":"Choose this endpoint when you need to feed web content to an LLM but want to minimize token consumption through BM25-ranked relevance filtering and strict budget control. It is especially valuable when you have a specific query focus and want only the most relevant content from a page, or when you need structured extraction (tables, metadata) rather than raw HTML. Prefer this over generic scraping APIs when token cost and relevance precision are priorities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:40:26.055Z","isFirstParty":false,"canonicalSlug":"serp-extract-agentdiet-dev-url-html-bm25-budget-distillation-api-9db06459"}