신원 및 검증

브랜드 데이터 API

요청 한 번으로 기업의 브랜드 정보를 채우세요. 도메인, 주식 티커, ISIN 또는 기업 이름을 보내면 이름, 설명, 선언된 소셜 프로필, 이미지 URL 형태의 정사각형 로고와 와이드 로고, 그리고 로고 자체에서 읽어 낸 브랜드 색상을 받을 수 있으며, 각 항목에는 출처와 확인 시각이 함께 제공됩니다.

문서 보기 모든 API 살펴보기

엔드포인트 활성

GET /v1/brand

예제 요청

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

예제 응답 200 OK

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "
...

예제 요청 GET /v1/brand

주요 기능 4

자주 묻는 질문 4

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

카테고리 신원 및 검증

엔드포인트 1

주요 기능 4

자주 묻는 질문 4

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

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

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

실시간 서비스 상태

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

OpenAPI API 자료

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

API 키 보호된 액세스

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

1,000 무료 크레딧

매월 무료 크레딧 1,000개로 시작하세요. 더 필요하신가요? 월간 요금제를 선택하거나 일회성 팩을 구매하세요.

이 API로 만들 수 있는 것

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

제품 워크플로

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

분석가 자동화

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

깔끔한 JSON 데이터

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

AI 및 운영 도구

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

통합 워크플로

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

한 번 인증

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

예제로 조회

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

운영 및 모니터링

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

개발자 키트

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

OpenAPI 스키마

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

Postman 컬렉션

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

SDK 및 CLI

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

MCP 통합

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

매개변수 및 응답 맵

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

요청 매개변수

매개변수

domaintickerexchangeisinname

응답 필드

예제 응답

queryquery.typequery.valuequery.exchangestatusdomainnamename.statusname.valuename.provenancename.provenance.sourcename.provenance.method

상태 범위

HTTP 상태 코드

200304400401402429

엔드포인트

GET /v1/brand

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

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

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

실시간 서비스 상태

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

OpenAPI API 자료

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

API 키 보호된 액세스

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

1,000 무료 크레딧

매월 무료 크레딧 1,000개로 시작하세요. 더 필요하신가요? 월간 요금제를 선택하거나 일회성 팩을 구매하세요.

주요 기능

로고에서 읽어 낸 색상

팔레트는 디코딩된 로고의 픽셀에서 만들어지며, 투명한 영역과 단색 배경은 제외되고 hex, RGB, OKLCH로 제공됩니다. 웹사이트가 선언한 theme_color는 별도로 보고됩니다.

정사각형 및 와이드 로고

정사각형 브랜드 마크와, 웹사이트가 게시한 경우 와이드 헤더 또는 워드마크 로고를 받을 수 있습니다. 두 로고 모두 다운로드하고 디코딩한 뒤에 반환됩니다.

알 수 없음은 없음이 아닙니다

각 필드는 있음, 없음, 알 수 없음 중 하나로 표시됩니다. 요청을 차단하거나 시간이 초과된 웹사이트는 빈 값이 아니라 알 수 없음 필드로 처리되며, 여러 기업과 일치하는 티커는 추측하지 않고 후보 목록을 반환합니다.

브랜드가 바뀌면 알림

브랜드 알림 구독으로 브랜드 도메인을 모니터링하면 로고, 색상, 이름 또는 소셜 프로필이 바뀔 때 웹훅으로 brand.updated를 받을 수 있습니다.

예제 요청

GET /v1/brand?domain=stripe.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

예제 응답

200 OK json

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "source": "touch_icon", "verification": "decoded", "native_width": 180, "native_height": 180 }
  },
  "wide_logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com?variant=wide", "source": "logo_image", "aspect_ratio": 2.4 }
  },
  "colors": {
    "status": "present",
    "value": {
      "from": "logo",
      "dominant": { "hex": "#635bff", "rgb": { "r": 99, "g": 91, "b": 255 }, "oklch": { "css": "oklch(57.84% 0.2346 278.29)" }, "share": 0.8712 },
      "background": null
    },
    "provenance": { "source": "logo_pixels", "method": "quantized_palette" }
  },
  "theme_color": { "status": "present", "value": { "declared": "#635BFF" }, "provenance": { "source": "website", "method": "meta_theme_color" } },
  "socials": { "status": "present", "value": [{ "platform": "x", "url": "https://x.com/stripe", "declared_by": "same_as" }] },
  "checked_at": "2026-11-02T10:00:00.000Z"
}

자주 묻는 질문

브랜드 조회에는 크레딧이 얼마나 드나요?

요청당 3크레딧이며, 없음과 알 수 없음 응답도 같습니다. 잘못된 요청과 DomScan 자체 기업 데이터를 사용할 수 없어 실패한 조회는 환불됩니다. 응답에 포함된 각 로고 이미지 URL은 요청할 때마다 1크레딧이 듭니다.

브랜드 데이터를 저장해도 되나요?

네. 결과와 로고를 직접 운영하는 시스템에 캐시하고 저장할 수 있습니다. 응답에는 ETag와 캐시 헤더가 포함되어 있어 저장한 사본을 다시 검증할 수 있습니다. 로고와 이름은 각 소유자의 상표입니다.

브랜드 색상은 어디에서 가져오나요?

디코딩된 로고의 픽셀에서 가져옵니다. 비슷한 색은 하나로 묶고, 투명한 부분과 단색 배경은 제외하며, 같은 로고는 항상 같은 팔레트를 만듭니다. 웹사이트가 선언한 theme_color는 별도의 필드입니다.

주식 티커로 브랜드를 조회할 수 있나요?

네. domain 대신 ticker(필요하면 exchange와 함께), isin 또는 name을 보내세요. 도메인은 정확히 한 기업만 일치할 때만 사용되며, 그렇지 않으면 이유와 후보 목록이 포함된 알 수 없음이 반환됩니다.

HTTP 상태 코드

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

성공 200

요청 성공

HTTP 304 304

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

잘못된 요청 400

잘못된 매개변수

인증되지 않음 401

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

결제 필요 402

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

요청 과다 429

속도 제한 초과

브랜드 조회

무료로 시작 문서 보기

지원

브랜드 데이터 API

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

이 API로 만들 수 있는 것

통합 워크플로

개발자 키트

매개변수 및 응답 맵

엔드포인트

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

주요 기능

예제 요청

예제 응답

자주 묻는 질문

관련 도구 및 리소스

HTTP 상태 코드