API sənədləri

Sərbəst hədəf axtarışı

Domen, e-poçt, IPv4/CIDR, HWID, kompüter adı, fayl adı/yolu, URL, istifadəçi adı, açar söz, port ilə domen (`darkradar.com:8443`), sxem ilə domen (`ftp://darkradar.com`) və ya fayl uzantısı (`.kdbx`) ilə sızma axtarışı. CIDR prefiksi /16–/32 olmalıdır. `pc`, `file` və `url` ən azı 4 simvoldur; coker işarəsi qəbul edilmir. `site` verilərsə, e-poçt və ya istifadəçi adı axtarışı həmin saytla daralır və yoluxma siyahısı qayıtmır. Növbəti səhifə üçün cavabdakı `pageInfo.nextCursor` dəyərini `cursor` kimi göndərin. Axtarış kredit xərcləmir. `partial: true` axtarışın vaxt həddinə çatdığını və nəticələrin natamam ola biləcəyini bildirir. Sirlər maskalı qaytarılır.

GET/v1/hunter/search
GETSərbəst hədəf axtarışı
curl -X GET "https://api.darkradar.com/api/public/v1/hunter/search?kind=domain&value=darkradar.com" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Cavab

Uğurlu

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

Giriş icazəsi

Əhatəhunter:search
Plan hüququintel_hunter

Sorğu parametrləri

SahələrDəyərlər
kind · string · məcburiHədəf növü · Dəyərlər: domain, email, ip, hwid, pc, file, url, username, keyword, port, scheme, ext · Nümunə: domain
value · string · məcburiAxtarılacaq dəyər · Nümunə: darkradar.com
limit · integer · istəyə bağlıSəhifə başına qeyd (ən çox 100) · Nümunə: 50
cursor · string · istəyə bağlıNövbəti səhifənin kursoru (cavabdakı dəyər olduğu kimi göndərilir)
site · string · istəyə bağlıE-poçt və ya istifadəçi adı axtarışını bir saytla daraldır · Nümunə: vpn.darkradar.com
country · string · istəyə bağlıÖlkə koduna görə süz · Nümunə: TR
stealerFamily · string · istəyə bağlıZərərli proqram ailəsinə görə süz · Nümunə: Lumma
from · string · istəyə bağlıBu tarixdən sonra (ISO 8601) · Nümunə: 2026-01-01
to · string · istəyə bağlıBu tarixdən əvvəl (ISO 8601) · Nümunə: 2026-09-20
hasWallet · boolean · istəyə bağlıPul kisəsi izi olan (true) və ya olmayan (false) nəticələr · Nümunə: true
hasCard · boolean · istəyə bağlıKart izi olan (true) və ya olmayan (false) nəticələr · Nümunə: false
hasCookies · boolean · istəyə bağlıKukisi olan (true) və ya olmayan (false) nəticələr · Nümunə: true
hasServices · boolean · istəyə bağlıXidmət qeydi olan (true) və ya olmayan (false) nəticələr · Nümunə: true

Cavablar

200Uğurlu
400Sorğu etibarsızdır (pozuq kimlik, çatışmayan və ya səhv sahə)
401Açar yoxdur, etibarsızdır, müddəti bitib və ya ləğv edilib
403Əhatə kifayət etmir, planda API girişi yoxdur və ya məhsul açıq deyil
404Qeyd yoxdur və ya bu açarın şirkətinə aid deyil
408Sorğu maksimum cavab müddətini aşdı
429Firma üzrə dəqiqəlik sorğu həddi aşıldı; `Retry-After` başlığındakı saniyə qədər gözləyin
503Threat Investigation müvəqqəti olaraq cavab vermir; avtomatik yenidən sınamayın, bir müddət sonra özünüz yoxlayın

Cavab limitləri

Səhifə ölçüsülimit · susmaya görə 50 · maksimum 200
Sürət limiti15 dəqiqədə 500 sorğu · IP başına
Threat Investigation1 dəqiqədə 20 sorğu · firma başına

Bu səhifə işinizə yaradı?