{"uid":"cap_BuMejgJrDzjPQXix6STPk","slug":"agentdiet-dev-agentdiet-context-compress-web-url-distillation-api-d58464bb","name":"AgentDiet Context Compress — Web URL 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/v1/context-compress)","url":"https://agentdiet.dev/v1/context-compress?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_ZUWIIq2v04NllPdgC1ad6","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 and compresses a webpage URL (or raw HTML) into compact, agent-ready tokens using BM25 budget control and multiple distillation modes","exampleAgentPrompt":"Distill the Stripe pricing page at https://stripe.com/pricing into compact markdown using budget mode, focused on 'payment fees', and keep it under 500 tokens.","exampleUseCases":[{"title":"Compress docs page before GPT call","prompt":"Fetch https://docs.openai.com/api-reference and distill it into structured markdown so I can paste it into my prompt without blowing my context window."},{"title":"BM25 focused excerpt for research","prompt":"Pull https://arxiv.org/abs/2310.06825 and give me just the parts about 'retrieval augmented generation' in budget mode, capped at 300 tokens."},{"title":"Skeleton outline of competitor site","prompt":"Grab https://anthropic.com/claude and return a skeleton outline of the page so I can see the high-level structure without all the fluff."}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (Markdown, structured JSON, skeleton, or BM25 excerpt depending on mode), an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and llm_cost_saved_usd, optional cache status (HIT/MISS), billing details, and an overall status string.","failureModes":["Invalid or unreachable URL returns an error status","Token budget too low (max_tokens < 20) rejected at validation","BM25 query provided without mode=budget may be ignored","Raw HTML payload too large may time out or truncate","Payment not provided or insufficient for x402 monetized endpoint","mode enum value outside allowed set returns validation error"],"whenToPreferThis":"Choose this endpoint when you need to feed web content into an LLM but want to minimize token usage and cost — especially useful for long documentation pages, competitor sites, or research papers. Prefer it over raw web scraping when token budget control and compression ROI metrics matter. The BM25 budget mode is particularly valuable when you have a specific query and a strict context window limit.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:50:09.912Z","isFirstParty":false,"canonicalSlug":"agentdiet-dev-agentdiet-context-compress-web-url-distillation-api-d58464bb"}