{"id":"web.link-shortlist","version":"1.0.0","category":"web","description":"Rank real links in supplied HTML against a query; return direct URLs and matched words instead of a page dump. No search or destination verification.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"html":{"type":"string","maxLength":100000},"sourceUrl":{"type":"string","maxLength":2048},"query":{"type":"string","minLength":1,"maxLength":300},"maxLinks":{"type":"integer","minimum":1,"maximum":20,"default":5}},"required":["html","sourceUrl","query"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"sourceUrl":{"type":"string"},"query":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"label":{"type":"string"},"score":{"type":"number"},"matchedTerms":{"type":"array","items":{"type":"string"}}},"required":["url","label","score","matchedTerms"],"additionalProperties":false}},"matchingLinks":{"type":"number"},"truncated":{"type":"boolean"},"scope":{"type":"string"},"measurement":{"type":"object","properties":{"inputBytes":{"type":"number"},"payloadBytes":{"type":"number"},"estimatedInputTokens":{"type":"number"},"estimatedPayloadTokens":{"type":"number"},"estimateMethod":{"type":"string"}},"required":["inputBytes","payloadBytes","estimatedInputTokens","estimatedPayloadTokens","estimateMethod"],"additionalProperties":false}},"required":["sourceUrl","query","links","matchingLinks","truncated","scope","measurement"],"additionalProperties":false},"example":{"html":"<html><head><title>Example API docs</title></head><body><nav>Home Account Ads</nav><main><h1>Example API</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre><a href=\"/docs/auth\">Authentication</a><a href=\"/docs/pricing\">API pricing</a></main></body></html>","sourceUrl":"https://example.com/docs","query":"API pricing","maxLinks":3},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/web.link-shortlist","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/web.link-shortlist","page":"https://agent-utilities.agent-utilities.workers.dev/tools/web.link-shortlist","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/web.link-shortlist","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}}