開発者向けリファレンス

ブランドモニタリング

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"
}