Entwickler-Referenz

Markenüberwachung

DomScan API: Kontinuierliche Markenüberwachung. Verfolgen Sie Typosquatting-Bedrohungen und Versuche der Markenimitation.

Markenüberwachung

Kontinuierliche Markenüberwachung. Verfolgen Sie Typosquatting-Bedrohungen und Versuche der Markenimitation.

GET /v1/brand-monitor

Rufen Sie alle überwachten Marken und ihren aktuellen Bedrohungsstatus ab.

Beispielantwort

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

Antwort-Felder

Feld	Typ
`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

Erstellen Sie eine neue Markenüberwachung.

Request Body

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

Antwort-Felder

Feld	Typ
`success`	boolean
`message`	string
`brand`	object
`brand.domain`	string
`brand.baseline_threats`	integer
`brand.scan_status`	string
`initial_scan`	object \| null

Beispielantwort

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

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

Starten Sie sofort einen Scan für eine überwachte Marke.

Antwort-Felder

Feld	Typ
`success`	boolean
`scan`	object \| null
`alert`	object
`alert.level`	string
`alert.message`	string

Beispielantwort

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

DELETE /v1/brand-monitor

Abfrageparameter

Parameter	Typ	erforderlich
domain	string	erforderlich

Antwort-Felder

Feld	Typ
`success`	boolean
`message`	string

Beispielanfrage

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 '{}'

Beispielantwort

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

GET /v1/brand-monitor/status

Abfrageparameter

Parameter	Typ	erforderlich
domain	string	erforderlich

Antwort-Felder

Feld	Typ
`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

Beispielanfrage

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

Beispielantwort

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

Abfrageparameter

Parameter	Typ	erforderlich
domain	string	erforderlich

Antwort-Felder

Feld	Typ
`success`	boolean
`message`	string

Beispielanfrage

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 '{}'

Beispielantwort

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

PUT /v1/brand-monitor/alerts

Body-Parameter

Parameter	Typ	erforderlich
domain	string	erforderlich
alert_email	string \| null	optional
alert_webhook	string \| null	optional

Antwort-Felder

Feld	Typ
`success`	boolean
`message`	string

Beispielanfrage

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

Beispielantwort

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