API belgeleri

İz kaydını listele

Firmanızın Threat Investigation işlemleri, en yeni önce: kim (kullanıcı ya da API anahtarı), ne zaman, hangi hedef türü, kaç kredi, kaç sonuç. E-posta, kullanıcı adı, bilgisayar adı ve donanım kimliği hedefleri maskeli döner; IP ve tarayıcı bilgisi dönmez. Kredi harcamaz.

GET/v1/hunter/audit
GETİz kaydını listele
curl -X GET "https://api.darkradar.com/api/public/v1/hunter/audit" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Yanıt

Başarılı

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "64b1f0c2a9e4d21f8c3b9a50",
        "createdAt": "2026-10-30T09:12:00.000Z",
        "actorKind": "apikey",
        "apiKeyId": "64b1f0c2a9e4d21f8c3b9a01",
        "action": "query",
        "targetKind": "email",
        "targetValue": "a***@darkradar.com",
        "creditsSpent": 0,
        "resultCount": 4
      }
    ],
    "total": 1
  }
}

Yetki

Kapsamhunter:search
Plan yetkisiintel_hunter

Sorgu parametreleri

AlanlarDeğerler
from · string · isteğe bağlıBu tarihten sonra (ISO 8601) · Örnek: 2026-10-01
to · string · isteğe bağlıBu tarihten önce (ISO 8601) · Örnek: 2026-10-31
action · string · isteğe bağlıİşlem türü · Değerler: query, target.add, target.remove, unmask, export · Örnek: query
apiKeyId · string · isteğe bağlıYalnız bu API anahtarı · Örnek: 64b1f0c2a9e4d21f8c3b9a01
limit · integer · isteğe bağlıSayfa başına kayıt (en çok 100) · Örnek: 100

Yanıtlar

200Başarılı
400İstek geçersiz (bozuk kimlik, eksik ya da hatalı alan)
401Anahtar yok, geçersiz, süresi dolmuş ya da iptal edilmiş
403Kapsam yetersiz, planda API erişimi yok ya da ürün açık değil
404Kayıt yok ya da bu anahtarın firmasına ait değil
408İstek azami yanıt süresini aştı
429Hız sınırı aşıldı; bir dakika sonra tekrar deneyin

Yanıt sınırları

Sayfa boyutulimit · varsayılan 100 · en çok 500
Hız sınırı15 dakikada 500 istek · IP başına
Threat Investigation1 dakikada 20 istek · firma başına

Bu sayfa işinize yaradı mı?