{"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":300,"priceRevision":"2026-09-13-testnet","pricingStatus":"experimental-unbenchmarked","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":"Example API docs
Example API
Requests time out after 30 seconds. Retry only idempotent requests.