GET /v1/brand-monitor
작업: getBrandMonitors
크레딧 및 인증: 1
인증 필요
응답 필드
| 필드 |
유형 |
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 |
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand-monitor"
예제 응답
{
"brands": [
{
"domain": "example.com",
"added_at": "2026-04-15T12:00:00Z",
"last_scan_at": "2026-04-15T12:00:00Z",
"scan_count": 1,
"registered_typos": 1,
"new_threats_since_baseline": 1,
"has_alerts": true,
"scan_status": "pending"
}
],
"total": 1,
"updated_at": "2026-04-15T12:00:00Z"
}
POST /v1/brand-monitor
작업: createBrandMonitor
크레딧 및 인증: 3
인증 필요
본문 매개변수
| 매개변수 |
유형 |
필수 |
| domain |
string
|
필수 |
| alert_email |
string
|
선택 사항 |
| alert_webhook |
string
|
선택 사항 |
응답 필드
| 필드 |
유형 |
success |
boolean |
message |
string |
brand |
object |
brand.domain |
string |
brand.baseline_threats |
integer |
brand.scan_status |
string |
initial_scan |
object | null |
예제 요청
curl -X POST "https://domscan.net/v1/brand-monitor" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"domain": "example.com",
"alert_email": "[email protected]",
"alert_webhook": "https://example.com"
}'
예제 응답
{
"success": true,
"message": "string",
"brand": {
"domain": "example.com",
"baseline_threats": 1,
"scan_status": "pending"
},
"initial_scan": {}
}
DELETE /v1/brand-monitor
작업: deleteBrandMonitor
크레딧 및 인증: 1
인증 필요
쿼리 매개변수
| 매개변수 |
유형 |
필수 |
| 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"
}
POST /v1/brand-monitor/scan
작업: triggerBrandScan
크레딧 및 인증: 6
인증 필요
쿼리 매개변수
| 매개변수 |
유형 |
필수 |
| domain |
string
|
필수 |
응답 필드
| 필드 |
유형 |
success |
boolean |
scan |
object | null |
alert |
object |
alert.level |
string |
alert.message |
string |
예제 요청
curl -X POST "https://domscan.net/v1/brand-monitor/scan?domain=example.com" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{}'
예제 응답
{
"success": true,
"scan": {},
"alert": {
"level": "medium",
"message": "string"
}
}
GET /v1/brand-monitor/status
작업: getBrandMonitorStatus
크레딧 및 인증: 1
인증 필요
쿼리 매개변수
| 매개변수 |
유형 |
필수 |
| 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": "[email protected]",
"webhook": "string"
}
}
POST /v1/brand-monitor/reset-baseline
작업: resetBrandMonitorBaseline
크레딧 및 인증: 1
인증 필요
쿼리 매개변수
| 매개변수 |
유형 |
필수 |
| 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
작업: updateBrandMonitorAlerts
크레딧 및 인증: 1
인증 필요
본문 매개변수
| 매개변수 |
유형 |
필수 |
| 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": "[email protected]",
"alert_webhook": "https://example.com"
}'
예제 응답
{
"success": true,
"message": "string"
}