신원 및 검증

아바타 및 로고 조회 API

모든 사용자, 리드, 기업 옆에 실제 얼굴이나 로고를 보여 주세요. 이메일 주소, 사용자 이름 또는 도메인을 보내면 가장 적합한 검증된 이미지와 출처를 받을 수 있고, 이미지가 없을 때는 솔직하게 없다고 알려 줍니다.

문서 보기 모든 API 살펴보기

엔드포인트 활성

GET /v1/avatar

예제 요청

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

예제 응답 200 OK

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates"
...

예제 요청 GET /v1/avatar

주요 기능 4

자주 묻는 질문 4

HTTP 상태 코드 200 / 400 / 401 / 402 / 429

카테고리 신원 및 검증

엔드포인트 1

주요 기능 4

자주 묻는 질문 4

다음 회사의 사람들이 사용합니다

연동 전 확인할 수 있는 신뢰 신호

투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.

실시간 서비스 상태

통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.

OpenAPI API 자료

OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.

API 키 보호된 액세스

인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.

1,000 무료 한도

UTC 기준 매월 무료 크레딧 1,000개로 시작하세요. 더 필요하면 월간 요금제를 선택하거나 일회성 팩을 구매할 수 있습니다.

이 API로 만들 수 있는 것

이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.

제품 워크플로

도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.

분석가 자동화

반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.

깔끔한 JSON 데이터

제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.

AI 및 운영 도구

OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.

통합 워크플로

첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.

한 번 인증

문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.

예제로 조회

curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.

운영 및 모니터링

상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.

개발자 키트

이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.

OpenAPI 스키마

클라이언트를 생성하거나 모든 요청 및 응답 구조를 확인하세요.

Postman 컬렉션

수동 테스트와 팀 인계를 위한 준비된 요청을 가져오세요.

SDK 및 CLI

보일러플레이트 대신 유지관리되는 패키지와 명령줄 워크플로를 사용하세요.

MCP 통합

도메인 인텔리전스를 AI 에이전트와 내부 어시스턴트 워크플로에 노출하세요.

매개변수 및 응답 맵

엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.

요청 매개변수

매개변수

emailusernameplatformdomain

응답 필드

예제 응답

inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates

상태 범위

HTTP 상태 코드

200400401402429

엔드포인트

GET /v1/avatar

크레딧: 2인증: 인증이 필요합니다

연동 전 확인할 수 있는 신뢰 신호

투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.

실시간 서비스 상태

통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.

OpenAPI API 자료

OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.

API 키 보호된 액세스

인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.

1,000 무료 한도

UTC 기준 매월 무료 크레딧 1,000개로 시작하세요. 더 필요하면 월간 요금제를 선택하거나 일회성 팩을 구매할 수 있습니다.

주요 기능

이메일, 사용자 이름 또는 도메인

이메일 주소는 공개 아바타 서비스 및 해당 메일 도메인의 기업 로고와 대조합니다. 사용자 이름은 GitHub, Bluesky, Mastodon, Keybase에서 확인합니다. 도메인은 웹사이트 로고를 반환합니다.

검증된 이미지만 제공

반환되는 모든 이미지는 다운로드하여 실제 이미지인지 확인합니다. 오류 페이지, 깨진 링크, 기본 플레이스홀더는 절대 반환되지 않습니다.

모든 소스에 대한 근거 제공

각 소스는 present, absent, unknown 중 하나를 이유와 함께 보고하므로, 이미지가 없는 경우와 응답하지 않은 소스가 혼동되지 않습니다.

필요할 때 최신 결과

결과는 몇 시간 동안 재사용됩니다. max_age를 보내 저장된 응답의 허용 경과 시간을 지정하거나, max_age=0을 보내 새로 확인할 수 있습니다.

예제 요청

GET /v1/avatar?username=octocat bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

예제 응답

200 OK json

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates": [
    {
      "source": "github",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://avatars.githubusercontent.com/u/583231?v=4",
      "verified": true,
      "content_type": "image/png",
      "profile_url": "https://github.com/octocat",
      "may_be_generated": true
    },
    {
      "source": "bluesky",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
      "verified": true,
      "content_type": "image/jpeg",
      "profile_url": "https://bsky.app/profile/octocat.bsky.social"
    },
    { "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
  ],
  "status": "present",
  "checked_at": "2026-11-02T10:00:00.000Z"
}

자주 묻는 질문

어떤 소스를 확인하나요?

이메일: Gravatar, Libravatar, 기업 메일 도메인의 BIMI 로고. 사용자 이름: GitHub, Bluesky, Mastodon, Keybase 또는 선택한 플랫폼만. 도메인: 웹사이트가 게시한 로고나 아이콘과 해당 BIMI 로고.

absent는 무슨 뜻인가요?

모든 소스가 이미지가 없다고 명확하게 응답한 경우입니다. 계정이 없거나, 사진이 없는 계정이거나, 게시된 로고가 없는 경우가 해당합니다. 차단되었거나 느리거나 불분명한 소스가 하나라도 있으면 결과는 unknown입니다.

GitHub 사진이 자동 생성 가능성으로 표시되는 이유는 무엇인가요?

GitHub는 사진을 올리지 않은 계정에 자동 생성 패턴을 부여하며, 계정이 어느 쪽인지는 알려 주지 않습니다. 이런 사진은 아바타로 반환되지 않고, 다른 소스와 함께 목록에 표시되며 플래그가 붙습니다. 발견된 유일한 이미지라면 결과는 unknown입니다.

크레딧은 얼마나 드나요?

확인한 소스 수와 관계없이 조회 1회당 2크레딧입니다. unknown 결과는 환불됩니다.

HTTP 상태 코드

다음은 처리해야 할 HTTP 상태 코드입니다. 성공 응답, 인증 문제, 크레딧, 속도 제한, 누락된 데이터, 업스트림 장애를 구분하는 데 사용하세요.

성공 200

요청 성공

잘못된 요청 400

잘못된 매개변수

인증되지 않음 401

API 키 또는 세션이 없거나 유효하지 않습니다.

결제 필요 402

이 요청을 실행할 크레딧이 부족합니다.

요청 과다 429

속도 제한 초과

아바타 찾기

무료로 시작 문서 보기

지원

아바타 및 로고 조회 API

연동 전 확인할 수 있는 신뢰 신호

이 API로 만들 수 있는 것

통합 워크플로

개발자 키트

매개변수 및 응답 맵

엔드포인트

연동 전 확인할 수 있는 신뢰 신호

주요 기능

예제 요청

예제 응답

자주 묻는 질문

관련 도구 및 리소스

HTTP 상태 코드