{"uid":"cap__0yIY1yTLG1YY_6LJdkJU","slug":"preflight-agentdiet-dev-agentdiet-web-distillation-api-90fc1f93","name":"AgentDiet Web Distillation API","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://preflight.agentdiet.dev/api/diet)","url":"https://preflight.agentdiet.dev/api/diet?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_BU-liZWnM1i4Fwb_nrgGO","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"preflight.agentdiet.dev","brandSlug":"preflight-agentdiet-dev-mpp","brandBaseUrl":"https://preflight.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or raw HTML and distills it into compact, agent-ready tokens using BM25 budget control and multiple extraction modes","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/api and distill it into markdown, keeping it under 2000 tokens and focusing on the authentication section?","exampleUseCases":[{"title":"Fit docs into agent context window","prompt":"Pull the OpenAI API reference page at https://platform.openai.com/docs/api-reference and distill it into budget mode focused on 'rate limits', staying under 1500 tokens so it fits in my prompt."},{"title":"Extract structured data from product page","prompt":"Grab https://www.amazon.com/dp/B09XYZ and give me a structured JSON distillation of the product title, price, and specs — I need clean tables, not raw HTML."},{"title":"Skeleton outline for research navigation","prompt":"Distill https://en.wikipedia.org/wiki/Transformer_(machine_learning_model) into a skeleton outline so I can see the section headings and decide which parts are worth reading in full."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown, structured tables/metadata, skeleton outline, or BM25-ranked excerpt depending on mode), plus an ROI proof block showing raw token count, distilled token count, tokens saved, compression ratio percentage, estimated LLM cost saved in USD, and cache hit/miss status.","failureModes":["URL is unreachable or returns non-200 — distillation cannot proceed","HTML payload is empty or malformed — returns empty or low-quality distillation","max_tokens ceiling too low (below 20) — validation error","BM25 query provided without mode=budget — query may be ignored","Payment fails or x402 micropayment not completed — 402 response blocking access","Target URL is paywalled or requires login — only public content distilled"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read a web page but must stay within a token budget, or when raw HTML is too verbose to include in a prompt. It is especially valuable for LLM pipelines where context window cost matters, offering BM25-ranked relevance filtering not found in basic scrapers. Prefer it over generic web scrapers when you need built-in compression metrics and ROI proof of token savings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:23:45.329Z","isFirstParty":false,"canonicalSlug":"preflight-agentdiet-dev-agentdiet-web-distillation-api-90fc1f93"}