{"uid":"cap_sLrRi9KdGGuVar_oSNahZ","slug":"alpha-stream-agentdiet-dev-agentdiet-web-distillation-api-08ff8d20","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://alpha-stream.agentdiet.dev/v1/web-scrape)","url":"https://alpha-stream.agentdiet.dev/v1/web-scrape?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_qXVfUVyn9Sg4DsW5O7xTg","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"alpha-stream.agentdiet.dev","brandSlug":"alpha-stream-agentdiet-dev-mpp","brandBaseUrl":"https://alpha-stream.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and compresses a webpage or raw HTML into compact, agent-ready tokens using multiple distillation modes including BM25 budget-controlled extraction","exampleAgentPrompt":"Fetch the page at https://stripe.com/docs/payments and distill it into markdown, keeping it under 2000 tokens — I need a compact version I can feed into my context window.","exampleUseCases":[{"title":"Budget-focused competitor research","prompt":"Go to https://www.anthropic.com/product and distill it in budget mode, focused on 'pricing and model tiers', capped at 500 tokens — I just need the cost-relevant bits."},{"title":"Structured data extraction from landing page","prompt":"Fetch https://openai.com/api/ and extract it in structured mode so I get the tables and metadata as JSON — I want to parse the model specs programmatically."},{"title":"Skeleton outline of documentation","prompt":"Distill https://docs.github.com/en/actions into skeleton mode so I can see the high-level outline of the Actions documentation without reading the whole thing."}],"resultDescription":"Returns a data object containing the distilled page content in the requested format (Markdown, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt), along with ROI proof metrics showing raw vs. distilled token counts, compression ratio, tokens saved, and estimated LLM cost saved in USD. Also includes cache status and billing details.","failureModes":["Invalid or unreachable URL returns an error status","Token budget too low (below 20) triggers validation error","URL behind authentication or bot-protection may return incomplete content","Raw HTML injection via html parameter may produce garbled output if malformed","BM25 mode without a query parameter may fall back to default behavior","Rate limiting or payment failure via x402 may block the request"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to ingest live web content but must stay within a strict token budget. It is especially valuable when LLM context costs matter, when you need structured or skeleton extraction rather than raw HTML, or when BM25 relevance filtering is needed to focus on a specific topic within a large page. Prefer this over raw fetch-and-parse pipelines when you want compression ROI metrics and multi-mode distillation in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:25:42.646Z","isFirstParty":false,"canonicalSlug":"alpha-stream-agentdiet-dev-agentdiet-web-distillation-api-08ff8d20"}