{"uid":"cap_iOQd3MuOlAyEyl-aCWpL3","slug":"agentdiet-dev-agentdiet-web-distillation-api-b84ab7d0","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://agentdiet.dev/api/diet)","url":"https://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_X1Fo__Xj-1_LDQA3-NpXT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agentdiet.dev","brandSlug":"agentdiet-dev-mpp","brandBaseUrl":"https://agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or accepts raw HTML and distills it into compact, agent-ready tokens using BM25 budget control and multiple extraction modes","exampleAgentPrompt":"Can you distill https://stripe.com/docs/api into compact markdown for me, using budget mode with a focus query on 'payment intents' and a max of 500 tokens?","exampleUseCases":[{"title":"Token-budget research from live docs","prompt":"Fetch the OpenAI pricing page at https://openai.com/pricing and distill it into budget mode focused on 'embedding models', keeping it under 300 tokens so I can pass it to my agent without blowing my context window."},{"title":"Structured data extraction from a webpage","prompt":"Pull https://en.wikipedia.org/wiki/List_of_S%26P_500_companies and return it in structured mode so I get the tables and metadata as clean JSON I can work with."},{"title":"Skeleton outline of long documentation","prompt":"Give me a skeleton outline of https://docs.aws.amazon.com/lambda/latest/dg/welcome.html so I can see the high-level structure without reading the whole thing."}],"resultDescription":"Returns a JSON object containing: the distilled content (Markdown, structured JSON, skeleton, or BM25 excerpt) in 'data'; an 'roi_proof' object with raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, roi_multiplier, and llm_cost_saved_usd; optional cache metadata (HIT/MISS, latency); and billing details including fee charged in USD.","failureModes":["Invalid or unreachable URL returns an error status","mode=budget without a query or max_tokens may return unfiltered content","Raw HTML too large may exceed processing limits","Paywalled or JavaScript-heavy pages may return incomplete content","max_tokens set below 20 is rejected by schema validation","x402 payment failure results in 402 response and no content returned"],"whenToPreferThis":"Choose this endpoint when you need to compress a live webpage or raw HTML into the fewest possible tokens before passing it to an LLM, especially when working under strict context limits. It is uniquely suited for agentic pipelines where LLM token cost and context window size matter, offering BM25-ranked budget excerpts, structured table extraction, and compression ROI telemetry — features not typically found in generic web scrapers or summarizers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:25:45.734Z","isFirstParty":false,"canonicalSlug":"agentdiet-dev-agentdiet-web-distillation-api-640e00c8"}