POST AI agent ready /v1/favicon

Favicon API — бесплатный экстрактор Favicon

Передайте доменное имя и получите структурированный список всех значков, которые предоставляет сайт. API извлекает HTML, анализирует теги ссылок, проверяет распространенные резервные пути, такие как /favicon.ico, и возвращает каждый значок с его URL-адресом, объявленными размерами и типом MIME.

Endpoint

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

Миниатюры диспетчера закладок

Когда пользователь сохраняет закладку, вызовите API favicon, чтобы получить значок сайта и отобразить его рядом с заголовком. Это дает вашему менеджеру закладок полированный и визуальный список ссылок.

Обогащение предварительного просмотра ссылок

Объедините эту конечную точку с метаданными URL-адресов для создания карточек с расширенными ссылками. Покажите значок сайта, заголовок страницы и описание для каждого вставленного URL-адреса в приложении чата или редакторе CMS.

Панели конкурентного анализа

Извлеките значки списка доменов конкурентов и отобразите их на панели мониторинга. Мгновенная визуальная идентификация каждого бренда без загрузки значков вручную.

Frequently asked questions

Какие форматы значков распознает API?

Он обнаруживает значки ICO, PNG, SVG и Apple Touch, объявленные в заголовке HTML. Он также проверяет резервный путь /favicon.ico, если теги ссылок отсутствуют.

Соблюдает ли он перенаправления?

Да. API выполняет до 5 перенаправлений HTTP для достижения окончательного HTML-документа. Это обрабатывает домены, которые перенаправляются с www на не-www или с HTTP на HTTPS.

Что произойдет, если у домена нет значка?

API возвращает пустой массив значков. Никакой ошибки не выдается. Вы можете проверить длину массива, чтобы решить, отображать ли значок по умолчанию в вашем пользовательском интерфейсе.

Должен ли я включать «https://» в параметр домена?

Нет. Передайте пустой домен, например «github.com». API автоматически добавляет протокол и обрабатывает запросы HTTP и HTTPS.

Стабильны ли возвращаемые URL-адреса значков?

URL-адреса указывают на активные ресурсы в целевом домене, поэтому они могут измениться, если владелец сайта обновит свои значки. Для долгосрочного хранения загрузите значок и разместите его самостоятельно.

Get your API key

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