통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
이 API로 만들 수 있는 것
이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.
도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.
반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.
제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.
OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.
통합 워크플로
첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.
문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.
개발자 키트
이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.
매개변수 및 응답 맵
엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.
매개변수
예제 응답
HTTP 상태 코드
엔드포인트
/v1/identity-assets
/v1/identity-assets/bulk
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
주요 기능
구조화 데이터와 공개 웹사이트 메타데이터에 명시된 로고 후보를 찾습니다.
파비콘, Apple touch icon, 마스크 아이콘, 웹 매니페스트 참조를 추출합니다.
아이덴티티 자산과 함께 Open Graph 미리보기 이미지와 사이트가 명시한 테마 색상을 반환합니다.
각 후보의 출처, 자산 종류, MIME 유형, 명시된 크기를 확인할 수 있습니다.
웹사이트가 연결한 공개 프로필을 정규화해 출처와 신뢰도와 함께 제공합니다.
한 번의 요청으로 최대 10개 도메인을 처리하며, 입력 순서대로 결과와 항목별 오류를 반환합니다.
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-assets?domain=example.com"
curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
-d '{"domains":["example.com","github.com"]}' https://domscan.net/v1/identity-assets/bulk
예제 응답
{
"domain": "example.com",
"organization_name": "Example",
"assets": {
"logo_url": "https://example.com/logo.svg",
"favicon_url": "https://example.com/favicon.ico",
"theme_color": "#111827",
"candidates": []
},
"confidence": 0.8,
"evidence": ["organization_name", "structured_logo", "declared_icon"]
}
자주 묻는 질문
DomScan은 Organization 구조화 데이터에 명시된 로고를 우선하며, 다른 웹사이트 아이콘과 미리보기 이미지는 별도 후보로 유지합니다.
로고는 조직을 나타내고 파비콘은 웹사이트용 작은 아이콘입니다. API가 둘을 별도로 제공하므로 애플리케이션에 맞는 자산을 선택할 수 있습니다.
아니요. API는 원본 공개 자산 URL과 출처 정보를 반환합니다. 허용된 사용, 캐싱, 표시는 애플리케이션에서 관리해야 합니다.
logo 필드는 null로 유지됩니다. 다른 명시된 아이콘이나 미리보기 이미지는 로고로 잘못 표시되지 않고 별도 후보로 반환될 수 있습니다.
예. 일괄 엔드포인트에 최대 10개 도메인을 보낼 수 있습니다. 결과는 입력 순서를 유지하며 개별 실패가 성공한 항목을 가리지 않습니다.
관련 도구 및 리소스
HTTP 상태 코드
성공 응답, 인증 문제, 크레딧 부족, 속도 제한, 누락된 데이터, 업스트림 장애를 구분할 수 있도록 클라이언트에서 처리해야 할 HTTP 상태 코드를 문서화했습니다.
요청 성공
잘못된 매개변수
API 키 또는 세션이 없거나 유효하지 않습니다.
이 요청을 실행할 크레딧이 부족합니다.
속도 제한 초과
내부 오류
상위 RDAP 오류
업스트림 서비스를 사용할 수 없거나 일시적으로 속도 제한 중입니다.
업스트림 조회가 시간 초과되었습니다.
웹사이트 아이덴티티 데이터로 개발하기