빠른 시작

한 번의 HTTP 요청으로 어떤 도메인이든 깔끔한 로고를 가져옵니다.

Clearbit Logo API를 대체하시나요?

마이그레이션 가이드를 먼저 보고, 실제 도메인 몇 개를 바로 테스트해보세요.

예전 Clearbit 사용자는 "다른 로고 파일 소스"보다, UI에서 바로 쓸 수 있는 결과물이 더 필요합니다. 아래 두 문서가 가장 빠른 출발점입니다.

마이그레이션 가이드 읽기구매 가이드 읽기

ClearLogo 는 한 번의 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 키 발급 — 프로덕션 트래픽용 public 또는 secret 키를 로그인 후 만들 수 있습니다.
  • API 레퍼런스 — 엔드포인트, 파라미터, 인증 방식, 레이트 리밋 동작을 확인하세요.