API documentation

Start watching an asset

Add an email, domain, phone, username, national id or tax number to the watchlist and read that asset’s findings.

Add the asset

type and value are required, label is optional. The key needs the watch:write scope. If the value is already on the list, no new record is created and the response has deduped: true — the request is safe to repeat.

curl -X POST "https://api.darkradar.com/api/public/v1/watch/assets" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "email", "value": "[email protected]", "label": "Finans direktörü"}'
{
  "success": true,
  "data": {
    "assetId": "64b1f0c2a9e4d21f8c3b9a20",
    "deduped": false
  }
}

Read the asset’s findings

Filter findings to that asset with the returned assetId. Secrets come back masked (leakedSecretMasked).

curl -G "https://api.darkradar.com/api/public/v1/watch/findings" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  --data-urlencode "assetId=64b1f0c2a9e4d21f8c3b9a20"

Was this page helpful?