API referansı

Marka İzleyicisi API ürünü

Marka ihlali ve yazım hatası tehditleri için alanları izleyin. Bir işlem seçmek ve belgelenen yanıt sözleşmesini entegre etmek için bu referansı kullanın.

İşlemler

GET /v1/brand-monitor API referansını görüntüle
POST /v1/brand-monitor API referansını görüntüle
DELETE /v1/brand-monitor API referansını görüntüle
POST /v1/brand-monitor/scan API referansını görüntüle
GET /v1/brand-monitor/status API referansını görüntüle
POST /v1/brand-monitor/reset-baseline API referansını görüntüle
PUT /v1/brand-monitor/alerts API referansını görüntüle

GET /v1/brand-monitor

İşlem: getBrandMonitors Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli
GET /v1/brand-monitor

Yanıt Alanları

Alan Tür
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

Örnek İstek

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

Örnek Yanıt

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

İşlem: createBrandMonitor Krediler ve kimlik doğrulama: 3 Kimlik doğrulama gerekli
POST /v1/brand-monitor

Gövde Parametreleri

Parametre Tür gerekli
domain string gerekli
alert_email string isteğe bağlı
alert_webhook string isteğe bağlı

Yanıt Alanları

Alan Tür
success boolean
message string
brand object
brand.domain string
brand.baseline_threats integer
brand.scan_status string
initial_scan object | null

Örnek İstek

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

Örnek Yanıt

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

DELETE /v1/brand-monitor

İşlem: deleteBrandMonitor Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli
DELETE /v1/brand-monitor

Sorgu Parametreleri

Parametre Tür gerekli
domain string gerekli

Yanıt Alanları

Alan Tür
success boolean
message string

Örnek İstek

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

Örnek Yanıt

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

POST /v1/brand-monitor/scan

İşlem: triggerBrandScan Krediler ve kimlik doğrulama: 6 Kimlik doğrulama gerekli
POST /v1/brand-monitor/scan

Sorgu Parametreleri

Parametre Tür gerekli
domain string gerekli

Yanıt Alanları

Alan Tür
success boolean
scan object | null
alert object
alert.level string
alert.message string

Örnek İstek

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

Örnek Yanıt

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

GET /v1/brand-monitor/status

İşlem: getBrandMonitorStatus Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli
GET /v1/brand-monitor/status

Sorgu Parametreleri

Parametre Tür gerekli
domain string gerekli

Yanıt Alanları

Alan Tür
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

Örnek İstek

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

Örnek Yanıt

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

İşlem: resetBrandMonitorBaseline Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli
POST /v1/brand-monitor/reset-baseline

Sorgu Parametreleri

Parametre Tür gerekli
domain string gerekli

Yanıt Alanları

Alan Tür
success boolean
message string

Örnek İstek

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

Örnek Yanıt

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

PUT /v1/brand-monitor/alerts

İşlem: updateBrandMonitorAlerts Krediler ve kimlik doğrulama: 1 Kimlik doğrulama gerekli
PUT /v1/brand-monitor/alerts

Gövde Parametreleri

Parametre Tür gerekli
domain string gerekli
alert_email string | null isteğe bağlı
alert_webhook string | null isteğe bağlı

Yanıt Alanları

Alan Tür
success boolean
message string

Örnek İstek

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

Örnek Yanıt

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

Referans kaynakları