{"uid":"cap__aADHc5_0N1fQCk-CZ7QX","slug":"favicon-extract-80b5005f","name":"Favicon Extract","description":"x402 API catalogue for AI agents: 50 deterministic HTTP endpoints, paid per call with no account and no API key. One endpoint does one thing, always the same way, for a fraction of a cent.","url":"https://grist.tools/v1/favicon-extract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Absolute http(s) URL of the web page whose icon <link> tags (rel icon, shortcut, apple-touch-icon or mask-icon) are read, up to 2048 characters; /favicon.ico on its origin is added as a last candidate and icons are only fetched from the same registrable domain."}}},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["page_url","icons","selected"],"properties":{"icons":{"type":"array","items":{"type":"object","required":["url","rel","type","sizes"],"properties":{"rel":{"type":"string"},"url":{"type":"string"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"sizes":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"page_url":{"type":"string"},"selected":{"anyOf":[{"type":"object","required":["url","source_format","width","height","bytes","image_base64"],"properties":{"url":{"type":"string"},"bytes":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"width":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"image_base64":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_format":{"enum":["jpeg","png","gif","webp","tiff","avif","heic","svg","bmp","ico"],"type":"string"}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fs35hcjfxx3POGZMixMnD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and returns all favicon/icon URLs declared on a web page, plus a base64-encoded copy of the best selected icon.","exampleAgentPrompt":"Can you grab the favicon for https://stripe.com and give me the best one as a base64 image along with all the icon URLs declared on the page?","exampleUseCases":[{"title":"Brand asset pipeline for bookmarks","prompt":"I'm building a bookmarks app and need to show favicons next to each saved URL — can you extract the best icon from https://notion.so and give me its base64 image and dimensions?"},{"title":"Website directory thumbnail generation","prompt":"For my directory listing I need the favicon for https://linear.app — get me all the icon variants the page declares plus a base64 of whichever one looks best."},{"title":"Competitive intelligence dashboard","prompt":"I'm putting together a dashboard showing our competitors' branding — can you fetch all the favicon and apple-touch-icon links from https://figma.com and return the selected icon as a base64 PNG or SVG?"}],"resultDescription":"Returns a JSON object containing: page_url (the requested URL), icons (array of all detected icon link tags with rel, url, type, and sizes fields), and selected (the best icon with url, source_format, width, height, bytes, and image_base64 — or null if none could be fetched).","failureModes":["URL is unreachable or returns non-2xx status — selected may be null, icons array may be empty","Page has no icon link tags and /favicon.ico also returns 404 — selected is null","Icon hosted on a different registrable domain than the page — excluded from fetching","Malformed or non-http(s) URL input — validation error returned","Icon file is corrupt or in an unsupported format — selected may be null","URL exceeds 2048 character limit — request rejected"],"whenToPreferThis":"Choose this endpoint when you need to programmatically retrieve the best favicon or icon for any web page without maintaining a browser session, scraping infrastructure, or API keys. It is ideal for enriching link previews, bookmark managers, directory listings, or brand asset pipelines where you need both the icon URL list and a ready-to-use base64 image. Unlike generic scraping endpoints, it specifically understands icon link tag semantics (rel=icon, apple-touch-icon, mask-icon) and enforces same-domain fetching for security.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:43:12.229Z","isFirstParty":false,"canonicalSlug":"favicon-extract-80b5005f"}