개발자 참고자료

브랜드 모니터링

DomScan API로 브랜드를 지속적으로 모니터링하여 타이포스쿼팅 위협과 브랜드 사칭 시도를 추적합니다.

브랜드 모니터링

브랜드를 지속적으로 모니터링하여 타이포스쿼팅 위협과 브랜드 사칭 시도를 추적합니다.

GET /v1/brand-monitor

모니터링되는 모든 브랜드 및 현재 위협 상태를 조회합니다.

예제 응답

{
                "brands": [
                {
                "domain": "mycompany.com",
                "added_at": "2024-03-01T12:00:00Z",
                "last_scan_at": "2024-03-14T08:30:00Z",
                "scan_count": 6,
                "registered_typos": 3,
                "new_threats_since_baseline": 1,
                "has_alerts": true
                }
                ],
                "total": 1,
                "updated_at": "2024-03-14T08:30:00Z"
                }

응답 필드

필드	유형
`brands[]`	object[]
`brands[]`	object
`brands[].domain`	string
`brands[].added_at`	string
`brands[].last_scan_at`	string \| null
`brands[].scan_count`	integer
`brands[].registered_typos`	integer
`brands[].new_threats_since_baseline`	integer
`brands[].has_alerts`	boolean
`brands[].scan_status`	string
`total`	integer
`updated_at`	string

POST /v1/brand-monitor

새 브랜드 모니터링을 생성합니다.

요청 본문

{
                "domain": "mycompany.com",
                "alert_email": "security@example.com"
                }

응답 필드

필드	유형
`success`	boolean
`message`	string
`brand`	object
`brand.domain`	string
`brand.baseline_threats`	integer
`brand.scan_status`	string
`initial_scan`	object \| null

예제 응답

{
  "success": true,
  "message": "string",
  "brand": {
    "domain": "example.com",
    "baseline_threats": 1,
    "scan_status": "pending"
  },
  "initial_scan": {}
}

POST /v1/brand-monitor/scan?domain=mycompany.com

브랜드 모니터링의 즉시 스캔을 시작합니다.

응답 필드

필드	유형
`success`	boolean
`scan`	object \| null
`alert`	object
`alert.level`	string
`alert.message`	string

예제 응답

{
  "success": true,
  "scan": {},
  "alert": {
    "level": "medium",
    "message": "string"
  }
}

DELETE /v1/brand-monitor

쿼리 매개변수

매개변수	유형	필수
domain	string	필수

응답 필드

필드	유형
`success`	boolean
`message`	string

예제 요청

curl -X DELETE "https://domscan.net/v1/brand-monitor?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'

예제 응답

{
  "success": true,
  "message": "string"
}

GET /v1/brand-monitor/status

쿼리 매개변수

매개변수	유형	필수
domain	string	필수

응답 필드

필드	유형
`brand`	object
`brand.domain`	string
`brand.name`	string
`brand.tld`	string
`brand.added_at`	string
`brand.last_scan_at`	string \| null
`brand.scan_count`	integer
`threats`	object
`threats.baseline_count`	integer
`threats.current_count`	integer
`threats.new_since_baseline`	integer
`threats.new_threat_domains[]`	string[]
`threats.all_registered[]`	string[]
`alerts`	object
`alerts.email`	string \| null
`alerts.webhook`	string \| null

예제 요청

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

예제 응답

{
  "brand": {
    "domain": "example.com",
    "name": "string",
    "tld": "com",
    "added_at": "2026-04-15T12:00:00Z",
    "last_scan_at": "2026-04-15T12:00:00Z",
    "scan_count": 1
  },
  "threats": {
    "baseline_count": 1,
    "current_count": 1,
    "new_since_baseline": 1,
    "new_threat_domains": [
      "example.com"
    ],
    "all_registered": [
      "string"
    ]
  },
  "alerts": {
    "email": "alerts@example.com",
    "webhook": "string"
  }
}

POST /v1/brand-monitor/reset-baseline

쿼리 매개변수

매개변수	유형	필수
domain	string	필수

응답 필드

필드	유형
`success`	boolean
`message`	string

예제 요청

curl -X POST "https://domscan.net/v1/brand-monitor/reset-baseline?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'

예제 응답

{
  "success": true,
  "message": "string"
}

PUT /v1/brand-monitor/alerts

본문 매개변수

매개변수	유형	필수
domain	string	필수
alert_email	string \| null	선택 사항
alert_webhook	string \| null	선택 사항

응답 필드

필드	유형
`success`	boolean
`message`	string

예제 요청

curl -X PUT "https://domscan.net/v1/brand-monitor/alerts" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domain": "example.com",
  "alert_email": "alerts@example.com",
  "alert_webhook": "https://example.com"
}'

예제 응답

{
  "success": true,
  "message": "string"
}