Serbest hedef araması

Alan adı, e-posta, IPv4/CIDR, HWID, bilgisayar adı, dosya adı/yolu, URL, kullanıcı adı, anahtar kelime, port ile alan adı (`darkradar.com:8443`), şema ile alan adı (`ftp://darkradar.com`) ya da dosya uzantısıyla (`.kdbx`) sızıntı araması. CIDR öneki /16–/32 olmalıdır. `pc`, `file` ve `url` en az 4 karakterdir; joker kabul edilmez. `site` verilirse e-posta ya da kullanıcı adı araması o siteyle daralır ve bulaşma listesi dönmez. Sonraki sayfa için yanıttaki `pageInfo.nextCursor` değerini `cursor` olarak gönderin. Arama kredi harcamaz. `partial: true` aramanın süre sınırına takıldığını, sonuçların eksik olabileceğini söyler. Sırlar maskeli döner.

GET/v1/hunter/search

GETSerbest hedef araması

curl -X GET "https://api.darkradar.com/api/public/v1/hunter/search?kind=domain&value=darkradar.com" \
  -H "x-api-key: $DARKRADAR_API_KEY"

Yanıt

Başarılı

{
  "success": true,
  "data": {
    "items": [
      {
        "matchRef": "64b1f0c2a9e4d21f8c3b9a40",
        "source": "infostealer",
        "exposedFields": [
          "email",
          "password"
        ],
        "secretMasked": "Ya******23",
        "firstSeenAt": "2026-08-30T00:00:00.000Z",
        "seenAt": "2026-08-30T00:00:00.000Z"
      }
    ],
    "total": 1,
    "infections": [],
    "infectionTotal": 0,
    "summary": {
      "matches": 1,
      "infections": 0,
      "countries": {},
      "stealerFamilies": {},
      "firstSeenAt": "2026-08-30T00:00:00.000Z",
      "lastSeenAt": "2026-08-30T00:00:00.000Z",
      "hasWallet": false,
      "hasCard": false,
      "hasCookies": false,
      "hasServices": false,
      "hasFiles": false
    },
    "partial": false,
    "pageInfo": {
      "hasNext": true,
      "nextCursor": "eyJ0IjoiMjAyNi0wOC0zMFQwMDowMDowMC4wMDBaIn0"
    },
    "rateLimit": {
      "remaining": 19,
      "limit": 20
    }
  }
}

Yetki

Kapsamhunter:search

Plan yetkisiintel_hunter

Sorgu parametreleri

Alanlar	Değerler
`kind` · string · zorunlu	Hedef türü · Değerler: domain, email, ip, hwid, pc, file, url, username, keyword, port, scheme, ext · Örnek: `domain`
`value` · string · zorunlu	Aranacak değer · Örnek: `darkradar.com`
`limit` · integer · isteğe bağlı	Sayfa başına kayıt (en çok 100) · Örnek: `50`
`cursor` · string · isteğe bağlı	Sonraki sayfanın imleci (yanıttaki değer olduğu gibi gönderilir)
`site` · string · isteğe bağlı	E-posta ya da kullanıcı adı aramasını tek siteyle daraltır · Örnek: `vpn.darkradar.com`
`country` · string · isteğe bağlı	Ülke koduna göre süz · Örnek: `TR`
`stealerFamily` · string · isteğe bağlı	Zararlı yazılım ailesine göre süz · Örnek: `Lumma`
`from` · string · isteğe bağlı	Bu tarihten sonra (ISO 8601) · Örnek: `2026-01-01`
`to` · string · isteğe bağlı	Bu tarihten önce (ISO 8601) · Örnek: `2026-09-20`
`hasWallet` · boolean · isteğe bağlı	Cüzdan izi olan (true) ya da olmayan (false) sonuçlar · Örnek: `true`
`hasCard` · boolean · isteğe bağlı	Kart izi olan (true) ya da olmayan (false) sonuçlar · Örnek: `false`
`hasCookies` · boolean · isteğe bağlı	Çerezi olan (true) ya da olmayan (false) sonuçlar · Örnek: `true`
`hasServices` · boolean · isteğe bağlı	Servis kaydı olan (true) ya da olmayan (false) sonuçlar · Örnek: `true`

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ı

429Firma başına dakikalık istek sınırı aşıldı; `Retry-After` başlığındaki saniye kadar bekleyin

503Threat Investigation geçici olarak yanıt vermiyor; otomatik yeniden denemeyin, bir süre sonra kendiniz deneyin

Yanıt sınırları

Sayfa boyutulimit · varsayılan 50 · en çok 200

Hız sınırı15 dakikada 500 istek · IP başına

Threat Investigation1 dakikada 20 istek · firma başına