クイックスタート
任意のドメインから、1つの HTTP リクエストでクリーンで比率固定のロゴを取得します。
Clearbit Logo API から移行していますか?
まず移行ガイドをご覧ください。次に、実際のドメインでテストしてください。
Clearbit の旧ユーザーは「別のロゴファイルソース」よりも、UI で直接使用できるアウトプットが必要です。この 2 つのガイドが最速の出発点です。
ClearLogo は、1 回の GET リクエストで任意のドメインからクリーンで比率固定、テーマに合わせた不透明な背景のロゴ画像を返す HTTP API です。出力はテーマに合わせた不透明な正方形の画像です (ライトは白、ダークはダークニュートラル)。低ボリュームの閲覧にはログインは不要で、本番トラフィックではブラウザキーまたはサーバーキーを使用します。
1. キーなしで試す
低い使用量のブラウジング向けにエンドポイントはオープンです。ドメインを入力すると、すぐに 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 リファレンス — エンドポイント、パラメータ、認証方式、レート制限の動作を確認します。