Ontwikkelaarsreferentie

Domain Similarity API-documentatie

Domain Similarity API-documentatie: Vergelijk twee domeinen op visuele en tekstuele overeenkomst met behulp van meerdere algoritmen, inclusief Levenshtein-afstand, Jaro-Winkler-overeenkomst en visuele homoglief-analyse. Essentieel voor het detecteren van typosquatting, merkwerkvoorstelingskinderen, en phishing-domeinen.

Domain Similarity

Vergelijk twee domeinen op visuele en tekstuele overeenkomst met behulp van meerdere algoritmen, inclusief Levenshtein-afstand, Jaro-Winkler-overeenkomst en visuele homoglief-analyse. Essentieel voor het detecteren van typosquatting, merkwerkvoorstelingskinderen, en phishing-domeinen.

GET /v1/similarity

Queryparameters

Parameter	Type	Beschrijving
domain1 vereist	string	Eerste domein (meestal het legitieme domein)
domain2 vereist	string	Tweede domein (mogelijk verdacht domein)

Similarity Algorithms

Algoritme	Beschrijving
`levenshtein`	Bewerk afstand genormaliseerd (0-1)
`jaro_winkler`	Voorvoegsel-gewogen tekenreeksovereenkomst
`visual`	Homoglief/lookalike-tekendetectie

Voorbeeldverzoek

curl "https://domscan.net/v1/similarity?domain1=paypal.com&domain2=paypa1.com"

import requests

# Check multiple suspicious domains
legit = "paypal.com"
suspects = ["paypa1.com", "paypaI.com", "pаypal.com"]  # Note: last one has Cyrillic 'а'

for suspect in suspects:
    response = requests.get(
        "https://domscan.net/v1/similarity",
        params={"domain1": legit, "domain2": suspect}
    )
    data = response.json()
    print(f"{suspect}: {data['typosquatting_risk']} risk (visual: {data['similarity']['visual']:.2f})")

Voorbeeldantwoord

{
  "domain1": "paypal.com",
  "domain2": "paypa1.com",
  "similarity": {
    "levenshtein": 0.86,
    "jaro_winkler": 0.93,
    "visual": 0.95
  },
  "is_similar": true,
  "typosquatting_risk": "high",
  "homoglyphs_detected": ["l → 1"],
  "risk_factors": ["character_substitution", "high_visual_similarity"]
}

Antwoordvelden

Veld	Type
`domain1`	string
`domain2`	string
`similarity_score`	number
`visual_similarity`	number
`textual_similarity`	number
`is_confusable`	boolean
`risk_level`	string