API-Referenz

API für Markenüberwachung

Überwachen Sie Domains auf Marken-Verstöße und Typosquatting-Bedrohungen. Nutzen Sie diese Referenz, um eine Operation auszuwählen und den dokumentierten Response-Vertrag zu integrieren.

Operationen

GET /v1/brand-monitor API-Referenz ansehen
POST /v1/brand-monitor API-Referenz ansehen
DELETE /v1/brand-monitor API-Referenz ansehen
POST /v1/brand-monitor/scan API-Referenz ansehen
GET /v1/brand-monitor/status API-Referenz ansehen
POST /v1/brand-monitor/reset-baseline API-Referenz ansehen
PUT /v1/brand-monitor/alerts API-Referenz ansehen

GET /v1/brand-monitor

Operation: getBrandMonitors Credits und Authentifizierung: 1 Authentifizierung erforderlich
GET /v1/brand-monitor

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

Beispielanfrage

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand-monitor"

Beispielantwort

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

Operation: createBrandMonitor Credits und Authentifizierung: 3 Authentifizierung erforderlich
POST /v1/brand-monitor

Body-Parameter

Parameter Typ erforderlich
domain string erforderlich
alert_email string optional
alert_webhook string optional

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

Beispielanfrage

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

Beispielantwort

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

DELETE /v1/brand-monitor

Operation: deleteBrandMonitor Credits und Authentifizierung: 1 Authentifizierung erforderlich
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"
}

POST /v1/brand-monitor/scan

Operation: triggerBrandScan Credits und Authentifizierung: 6 Authentifizierung erforderlich
POST /v1/brand-monitor/scan

Abfrageparameter

Parameter Typ erforderlich
domain string erforderlich

Antwort-Felder

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

Beispielanfrage

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

Beispielantwort

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

GET /v1/brand-monitor/status

Operation: getBrandMonitorStatus Credits und Authentifizierung: 1 Authentifizierung erforderlich
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": "[email protected]",
    "webhook": "string"
  }
}

POST /v1/brand-monitor/reset-baseline

Operation: resetBrandMonitorBaseline Credits und Authentifizierung: 1 Authentifizierung erforderlich
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

Operation: updateBrandMonitorAlerts Credits und Authentifizierung: 1 Authentifizierung erforderlich
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": "[email protected]",
  "alert_webhook": "https://example.com"
}'

Beispielantwort

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

Referenzressourcen