Skip to content
POST AI agent ready /v1/favicon

Favicon API - Free Favicon Extractor

Pass a domain name and get back a structured list of all favicons the site exposes. The API fetches the HTML, parses link tags, checks common fallback paths like /favicon.ico, and returns each icon with its URL, declared sizes, and MIME type.

Parameters

stringrequired

The domain to extract favicons from. Do not include the protocol (https://).

Code examples

curl -X POST https://api.botoi.com/v1/favicon \
  -H "Content-Type: application/json" \
  -d '{"domain":"github.com"}'

When to use this API

Bookmark manager thumbnails

When a user saves a bookmark, call the favicon API to fetch the site icon and display it alongside the title. This gives your bookmark manager a polished, visual link list.

Link preview enrichment

Combine this endpoint with url-metadata to build rich link cards. Show the site favicon, page title, and description for every pasted URL in a chat app or CMS editor.

Competitive analysis dashboards

Pull favicons for a list of competitor domains and display them in a monitoring dashboard. Instant visual identification of each brand without manual icon uploads.

Frequently asked questions

What icon formats does the API detect?
It detects ICO, PNG, SVG, and Apple Touch icons declared in the HTML head. It also checks the /favicon.ico fallback path if no link tags are present.
Does it follow redirects?
Yes. The API follows up to 5 HTTP redirects to reach the final HTML document. This handles domains that redirect from www to non-www or from HTTP to HTTPS.
What happens if the domain has no favicon?
The API returns an empty favicons array. No error is thrown. You can check the array length to decide whether to show a default icon in your UI.
Should I include "https://" in the domain parameter?
No. Pass the bare domain like "github.com". The API adds the protocol automatically and handles both HTTP and HTTPS lookups.
Are the returned favicon URLs stable?
The URLs point to the live assets on the target domain, so they can change if the site owner updates their icons. For long-term storage, download the icon and host it yourself.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs