실시간
서비스 상태
통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
신원 및 검증
로고 이미지 API
제품 속 모든 도메인 옆에 기업 로고를 보여 주세요. /v1/logo/ 뒤에 도메인을 붙여 요청하면 img 태그에 바로 쓸 수 있는 크기의 정사각형 PNG를 받고, 출처를 알려 주는 헤더도 함께 받습니다. 이미지는 캐시하고 저장해 자체 서버나 CDN에서 제공해도 됩니다.
카테고리
신원 및 검증
엔드포인트
1
주요 기능
4
자주 묻는 질문
4
다음 회사의 사람들이 사용합니다
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI
API 자료
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
API 키
보호된 액세스
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
1,000
무료 크레딧
매월 무료 크레딧 1,000개로 시작하세요. 더 필요하신가요? 월간 요금제를 선택하거나 일회성 팩을 구매하세요.
이 API로 만들 수 있는 것
이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.
도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.
반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.
제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.
OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.
통합 워크플로
첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.
한 번 인증
문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.
예제로 조회
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
운영 및 모니터링
상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.
개발자 키트
이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.
매개변수 및 응답 맵
엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.
매개변수
domain
예제 응답
successdatameta
HTTP 상태 코드
401402
엔드포인트
GET
/v1/logo/:domain
domain
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
실시간
서비스 상태
통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
OpenAPI
API 자료
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
API 키
보호된 액세스
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
1,000
무료 크레딧
매월 무료 크레딧 1,000개로 시작하세요. 더 필요하신가요? 월간 요금제를 선택하거나 일회성 팩을 구매하세요.
주요 기능
진짜 로고 또는 솔직한 답변
로고는 기업이 직접 게시한 자료에서 가져옵니다. BIMI 메일 로고, 앱 아이콘, 터치 아이콘, 구조화 데이터 로고, 파비콘입니다. 모든 이미지는 반환하기 전에 내려받아 디코딩합니다. 로고가 없으면 404를 반환하고, fallback=monogram을 지정하면 생성된 글자 이미지를 반환하며 생성되었다는 표시가 항상 붙습니다.
인터페이스에 맞는 크기
16에서 512픽셀 사이의 원하는 크기, 2배 밀도를 위한 retina, greyscale, 그리고 theme=light 또는 theme=dark를 선택할 수 있습니다. 대비가 낮은 로고도 배경 위에서 잘 보이는 타일 위에 놓입니다. 이미지는 투명한 여백이 있는 정사각형입니다.
캐시하고 보관할 수 있습니다
응답에는 오래 유지되는 공개 캐시 헤더, ETag, Last-Modified가 포함됩니다. 브라우저와 CDN이 보관할 수 있고, 파일을 저장해 자체 서버에서 제공해도 됩니다. URL에 v=를 붙이면 변하지 않는 URL이 됩니다.
웹 페이지에서 안전하게 사용
token 파라미터에 공개용 키를 사용하면 지정한 웹사이트에서만 작동하며, 키별과 방문자별 한도가 적용됩니다. 시크릿 키는 서버의 X-API-Key 헤더에서만 사용하세요.
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
"https://domscan.net/v1/logo/stripe.com?size=128&retina=true"<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">예제 응답
HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999자주 묻는 질문
로고 하나에 크레딧이 얼마나 드나요?
요청당 1크레딧입니다. 캐시에서 제공한 로고, 생성된 글자 이미지, 로고가 없는 도메인, 304 Not Modified 응답도 같습니다. 잘못된 도메인이나 허용되지 않은 사이트에서 사용한 키처럼 처리 전에 거부된 요청에는 요금이 부과되지 않습니다. 페이지를 볼 때마다 가져오지 말고 이미지를 캐시하세요.
로고를 제 서버에 저장해도 되나요?
네. 반환된 이미지를 캐시하고 저장해 자체 서버나 CDN에서 제공할 수 있습니다. 로고는 여전히 각 소유자의 상표이므로, 해당 기업을 나타내는 용도로만 사용하세요.
찾을 수 없음과 사용할 수 없음은 어떻게 다른가요?
찾을 수 없음은 웹사이트와 메일 레코드가 응답했으며 사용할 수 있는 로고를 게시하지 않았다는 뜻이고, 이 결과는 한 시간 동안 재사용됩니다. 사용할 수 없음은 웹사이트가 차단했거나 느리거나 응답이 불분명해 결론을 내리지 못했다는 뜻이며, 몇 분 뒤에 다시 시도할 수 있습니다. X-Logo-Status로 둘을 구분할 수 있습니다.
로고의 출처는 어떻게 알 수 있나요?
X-Logo-Source에 bimi, manifest_icon, touch_icon, favicon 같은 출처가 표시되고, X-Logo-Verification은 이미지를 디코딩해 확인했음을 알려 줍니다. 생성된 글자 이미지에는 항상 X-Logo-Source: generated가 붙으며 로고로 표시되지 않습니다.
관련 도구 및 리소스
HTTP 상태 코드
다음은 처리해야 할 HTTP 상태 코드입니다. 성공 응답, 인증 문제, 크레딧, 속도 제한, 누락된 데이터, 업스트림 장애를 구분하는 데 사용하세요.
인증되지 않음
401
API 키 또는 세션이 없거나 유효하지 않습니다.
결제 필요
402
이 요청을 실행할 크레딧이 부족합니다.