{"uid":"cap_OGWy85N2XTa-Gz5IjQRRG","slug":"402utils-favicon-resolver-ff968a9f","name":"402utils Favicon Resolver","description":"Resolve a website's best icon: parses <head> for link rel=icon / apple-touch-icon / mask-icon, reads a linked web app manifest's icons, and adds the /favicon.ico fallback, then ranks them (scalable/large first). Returns the best iconUrl plus all ranked candidates with rel/sizes/type/source. The URL is SSRF-checked; fetches are capped. For agents building directories or UIs.","url":"https://402utils.com/v1/favicon?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public http(s) page URL (required)."}},"description":"Query string only."}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["url","finalUrl","iconUrl","candidates"],"properties":{"url":{"type":"string","description":"The URL as requested."},"iconUrl":{"type":"string","description":"The best icon (absolute). Falls back to <origin>/favicon.ico."},"finalUrl":{"type":"string","description":"URL after redirects; base for absolutization."},"candidates":{"type":"array","items":{"type":"object","required":["url","rel","source"],"properties":{"rel":{"type":"string","description":"icon / apple-touch-icon / mask-icon / manifest / fallback."},"url":{"type":"string"},"type":{"type":"string","description":"MIME type, when present."},"sizes":{"type":"string","description":"Declared sizes, when present."},"source":{"enum":["link","manifest","fallback"],"type":"string"}}},"description":"All discovered icons, ranked best-first."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","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":{"p10Cents":"0.2000","medianCents":"0.2000","p90Cents":"0.2000","minCents":"0.2000","maxCents":"0.2000","p95Cents":"0.2000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_V5TkFM4O3soBxaL_ipT2_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and ranks all icon candidates for a given website URL, returning the best icon URL plus all discovered favicon variants with metadata.","exampleAgentPrompt":"Can you find the best favicon icon for https://stripe.com — I want the highest quality one available, including any apple-touch-icon or manifest icons?","exampleUseCases":[{"title":"Build a bookmark collection with site icons","prompt":"I'm creating a personal bookmark manager and need to fetch the best icon for each of my saved websites. Can you get me the highest quality icon available for https://github.com, https://notion.so, and https://figma.com — including any apple-touch-icon variants they might have?"},{"title":"Generate preview cards for link sharing","prompt":"We're building a link preview feature in our app where users can share URLs. For these links — https://twitter.com, https://youtube.com, https://linkedin.com — can you fetch the best available icon for each one so we can display them nicely in the preview cards?"},{"title":"Populate directory with company logos","prompt":"I'm building a directory of SaaS companies and need to pull their official icons automatically. Can you find the best quality favicon for https://slack.com, https://zoom.us, and https://asana.com — I want to make sure I'm getting their actual logos, including any manifest icons they might provide?"}],"resultDescription":"Returns a JSON object with the best icon URL (iconUrl), the final URL after redirects (finalUrl), and an array of all discovered icon candidates ranked best-first, each including url, rel, sizes, type, and source (link/manifest/fallback).","failureModes":["URL fails SSRF check — returns error if the URL resolves to a private/internal IP","Fetch cap exceeded — returns error if the target site takes too long or responses are too large","Site has no discoverable icons — falls back to /favicon.ico which may also return 404","Invalid URL format — returns validation error if the url query param is malformed","Target site returns non-HTML content — manifest or link parsing may yield no candidates"],"whenToPreferThis":"Use this endpoint when you need to programmatically discover and rank all favicon/icon variants for any public website, especially when building directories, link previews, or UI dashboards that need the best available icon. It handles the full resolution chain (HTML link tags, web app manifests, and /favicon.ico fallback) in a single call with SSRF protection, making it safer and more complete than a naive fetch of /favicon.ico.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:52:49.073Z","isFirstParty":false,"canonicalSlug":"402utils-favicon-resolver-ff968a9f"}