> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/nl/docs/recipe-phishing-investigation

# Phishing-onderzoek

DomScan-API: Onderzoek verdachte phishingdomeinen met een bewijspakket.

Onderzoek verdachte phishingdomeinen met een bewijspakket. Het verzamelt DNS-records, WHOIS-gegevens en SSL-certificaten en maakt een rapport met tijdstempel voor verwijderingsverzoeken.

GET /v1/recipes/phishing-investigation Tegoeden: 12

#### Queryparameters

| Parameter | Type | vereist |
| --- | --- | --- |
| suspicious_domain | string | vereist |
| legitimate_domain | string | optioneel |
| collect_evidence | boolean Standaard `true` | optioneel |
| dry_run | string Toegestane waarden `true` | optioneel |

#### Antwoordvelden

| Veld | Type |
| --- | --- |
| `success` | boolean |
| `data` | object |
| `data.suspicious_domain` | string |
| `data.legitimate_domain` | string |
| `data.verdict` | string |
| `data.confidence` | number |
| `data.indicators` | object |
| `data.indicators.typosquatting` | object |
| `data.indicators.typosquatting.detected` | boolean |
| `data.indicators.typosquatting.technique` | string |
| `data.indicators.domain_age` | object |
| `data.indicators.domain_age.days` | number |
| `data.indicators.domain_age.risk` | string |
| `data.indicators.registration` | object |
| `data.indicators.registration.privacy_protected` | boolean |
| `data.indicators.registration.registrar` | string |
| `data.indicators.registration.created_date` | string |
| `data.indicators.infrastructure` | object |
| `data.indicators.infrastructure.ip` | string |
| `data.indicators.infrastructure.hosting` | string |
| `data.indicators.infrastructure.geolocation` | string |
| `data.indicators.ssl` | object |
| `data.indicators.ssl.valid` | boolean |
| `data.indicators.ssl.issuer` | string |
| `data.indicators.ssl.age_days` | number |
| `data.indicators.reputation` | object |
| `data.indicators.reputation.blocklisted` | boolean |
| `data.indicators.reputation.similar_reports` | number |
| `data.comparison_to_legitimate` | object |
| `data.comparison_to_legitimate.similarity_score` | number |
| `data.comparison_to_legitimate.visual_differences[]` | string[] |
| `data.evidence_package` | object |
| `data.evidence_package.dns_snapshot` | object |
| `data.evidence_package.dns_snapshot.A[]` | string[] |
| `data.evidence_package.whois_snapshot` | object |
| `data.evidence_package.whois_snapshot.registrar` | string |
| `data.evidence_package.timestamp` | string |
| `data.recommended_actions[]` | string[] |
| `meta` | object |
| `meta.recipe_name` | string |
| `meta.credits_used` | number |
| `meta.credits_saved` | number |
| `meta.duration_ms` | number |
| `meta.components_called[]` | string[] |
| `meta.cached_components[]` | array |
| `meta.timestamp` | string |
| `errors[]` | array |

#### Voorbeeldverzoek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/phishing-investigation?suspicious_domain=examp1e.com&legitimate_domain=example.com&collect_evidence=true"
```

```javascript
const response = await fetch("https://domscan.net/v1/recipes/phishing-investigation?suspicious_domain=examp1e.com&legitimate_domain=example.com&collect_evidence=true", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/recipes/phishing-investigation?suspicious_domain=examp1e.com&legitimate_domain=example.com&collect_evidence=true",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/recipes/phishing-investigation?suspicious_domain=examp1e.com&legitimate_domain=example.com&collect_evidence=true", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/recipes/phishing-investigation?suspicious_domain=examp1e.com&legitimate_domain=example.com&collect_evidence=true")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
```

#### Voorbeeldantwoord

```json
{
  "success": true,
  "data": {
    "suspicious_domain": "examp1e.com",
    "legitimate_domain": "example.com",
    "verdict": "confirmed_phishing",
    "confidence": 0.93,
    "indicators": {
      "typosquatting": {
        "detected": true,
        "technique": "character_swap"
      },
      "domain_age": {
        "days": 3,
        "risk": "high"
      },
      "registration": {
        "privacy_protected": true,
        "registrar": "Example Registrar",
        "created_date": "2026-04-12"
      },
      "infrastructure": {
        "ip": "203.0.113.18",
        "hosting": "Suspicious Hosting Ltd.",
        "geolocation": "NL"
      },
      "ssl": {
        "valid": true,
        "issuer": "Let's Encrypt",
        "age_days": 2
      },
      "reputation": {
        "blocklisted": true,
        "similar_reports": 4
      }
    },
    "comparison_to_legitimate": {
      "similarity_score": 0.97,
      "visual_differences": [
        "digit-substitution in second label character"
      ]
    },
    "evidence_package": {
      "dns_snapshot": {
        "A": [
          "203.0.113.18"
        ]
      },
      "whois_snapshot": {
        "registrar": "Example Registrar"
      },
      "timestamp": "2026-04-15T11:24:00Z"
    },
    "recommended_actions": [
      "Report to registrar abuse contact",
      "Submit URL to Safe Browsing and internal blocklists"
    ]
  },
  "meta": {
    "recipe_name": "phishing-investigation",
    "credits_used": 12,
    "credits_saved": 10,
    "duration_ms": 952,
    "components_called": [
      "whois",
      "dns",
      "ip",
      "reputation",
      "health",
      "certificates"
    ],
    "cached_components": [],
    "timestamp": "2026-04-15T11:24:00Z"
  },
  "errors": []
}
```

#### HTTP-statuscodes

- `200` OK
- `400` Ongeldig verzoek
- `401` Niet geautoriseerd
- `402` Betaling vereist
- `429` Te veel verzoeken
