Быстрый старт

Получите чистый логотип с корректным соотношением сторон для любого домена в одном HTTP-запросе.

Заменяете Clearbit Logo API?

Начните с руководства по миграции, затем протестируйте несколько доменов вживую.

Бывшим пользователям Clearbit обычно нужна не «другой источник файла логотипа», а результат, готовый к использованию в интерфейсе. Эти два руководства помогут вам начать быстрее.

Читайте руководство по миграцииЧитайте руководство покупателя

ClearLogo — это HTTP API, которое возвращает чистое изображение логотипа с корректным соотношением сторон на непрозрачном квадратном фоне, подобранном под тему (белый для светлой, тёмный нейтральный для тёмной), для любого домена через один GET-запрос. Для запросов низкого объёма вход не требуется; для боевого трафика используется браузерный или серверный ключ.

1. Попробуйте без ключа

Endpoint открыт для низкого объёма запросов. Передайте домен и получите PNG сразу же.

GET https://api.clearlogo.dev/logo/github.com?size=128&frame=fill&padding=10

Или вставьте прямо в HTML:

<img src="https://api.clearlogo.dev/logo/github.com?size=64&frame=fill&padding=10" alt="GitHub" />

2. Получите ключ для боевого использования

Создайте его из панели управления. Выберите тип в зависимости от того, откуда будет идти запрос:

  • Браузерный ключ — Вставляйте прямо в теги <img>. Запросы проверяются против списка разрешённых доменов на ключе.
  • Серверный ключ — Отправляйте как Authorization: Bearer …. Храните на бэкенде — никогда не отправляйте в браузер.

Войдите, чтобы создать ключ

3. Настройте выходные данные

Несколько параметров управляют большинством результатов: size, frame (fill заполняет канвас, original сохраняет оригинальное кадрирование иконки), padding (отступ с каждой стороны), shape (square или circle) и theme (светлый или тёмный вариант, который также задаёт цвет непрозрачного фона). Откройте тестовую среду, чтобы предпросмотреть комбинации перед копированием финального URL.

Дальнейшие шаги

  • Тестовая среда — Попробуйте все параметры и скопируйте точный URL, который будете использовать.
  • Получить API-ключ — Войдите и создайте публичный или секретный ключ для боевого трафика.
  • Справочник API — Изучите endpoint, параметры, способы аутентификации и поведение rate-limit.