Add a watched target

The target is scanned regularly; new leaks are added as findings. Each 30-day monitoring period spends 10 credits; the period renews when it ends and the target is paused if credits run out. If the target is already watched, no new record is created and no credits are spent (`deduped: true`, 200). Counts toward the target limit of your tier.

POST/v1/hunter/targets

POSTAdd a watched target

curl -X POST "https://api.darkradar.com/api/public/v1/hunter/targets" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"domain","value":"darkradar.com","label":"Ana alan adı"}'

Response

Created

{
  "success": true,
  "data": {
    "targetId": "64b1f0c2a9e4d21f8c3b9a60",
    "deduped": false,
    "paidUntil": "2026-12-01T08:00:00.000Z"
  }
}

Access

Scopehunter:write

Plan entitlementintel_hunter

Request body

Fields	Values
`kind` · string · required	Target type. `product`: a product or `product@domain` · Values: domain, email, ip, hwid, pc, file, url, username, keyword, port, product
`value` · string · required	Value to watch (2–256 characters)
`label` · string · optional	Display label (max 120 characters)

Responses

201Created

400Invalid request (malformed id, missing or invalid field)

401Key missing, invalid, expired or revoked

402The watched target limit of your tier is reached or your credit balance is too low; the target was not added

403Insufficient scope, no API access in plan, or product not enabled

404Record not found or not owned by this key’s firm

408The request exceeded its maximum response time

429The per-minute request limit for your firm was exceeded; wait the number of seconds in the `Retry-After` header

Response limits

Rate limit500 requests per 15 min · per IP

Threat Investigation20 requests per 1 min · per firm