POST AI agent ready /v1/favicon

Favicon API - 無料の Favicon 抽出ツール

ドメイン名を渡すと、サイトが公開するすべてのファビコンの構造化されたリストが返されます。 API は HTML を取得し、リンクタグを解析し、/favicon.ico などの一般的なフォールバックパスをチェックして、URL、宣言されたサイズ、および MIME タイプを含む各アイコンを返します。

Endpoint

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

When to use this API

ユーザーがブックマークを保存すると、favicon API を呼び出してサイトアイコンを取得し、タイトルの横に表示します。これにより、ブックマークマネージャーに洗練された視覚的なリンクリストが提供されます。

このエンドポイントを URL メタデータと組み合わせて、リッチリンクカードを構築します。チャットアプリまたは CMS エディターに、貼り付けられたすべての URL のサイトのファビコン、ページタイトル、説明を表示します。

競合ドメインのリストのファビコンを取得し、監視ダッシュボードに表示します。手動でアイコンをアップロードしなくても、各ブランドを瞬時に視覚的に識別できます。

API はどのようなアイコン形式を検出しますか?

HTML ヘッドで宣言された ICO、PNG、SVG、および Apple Touch アイコンを検出します。また、リンクタグが存在しない場合は、/favicon.ico フォールバックパスもチェックします。

リダイレクトに従いますか?

はい。 API は、最大 5 回の HTTP リダイレクトをたどって、最終的な HTML ドキュメントに到達します。これは、www から www 以外へ、または HTTP から HTTPS へリダイレクトするドメインを処理します。

ドメインにファビコンがない場合はどうなりますか?

API は空の favicon 配列を返します。エラーはスローされません。配列の長さを確認して、UI にデフォルトのアイコンを表示するかどうかを決定できます。

ドメインパラメータに「https://」を含める必要がありますか?

いいえ。「github.com」のようなベアドメインを渡します。 API はプロトコルを自動的に追加し、HTTP と HTTPS の両方のルックアップを処理します。

返されたファビコン URL は安定していますか?

URL はターゲットドメイン上のライブアセットを指すため、サイト所有者がアイコンを更新すると変更される可能性があります。長期保存するには、アイコンをダウンロードして自分でホストしてください。

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