> 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/ja/docs/similarity

# ドメイン類似度

DomScan APIでレーベンシュタイン距離、ジャロ・ウィンクラー類似度、視覚的な同形文字分析など、複数のアルゴリズムを使って、2つのドメインの見た目とテキストの類似度を比較します。

レーベンシュタイン距離、ジャロ・ウィンクラー類似度、視覚的な同形文字分析など、複数のアルゴリズムを使って、2つのドメインの見た目とテキストの類似度を比較します。タイポスクワッティング、ブランドのなりすまし、フィッシングドメインの検出に役立ちます。

GET /v1/similarity

#### クエリパラメータ

| パラメータ | タイプ | 説明 |
| --- | --- | --- |
| domain1 必須 | string | 最初のドメイン（通常は正当なドメイン） |
| domain2 必須 | string | 2 番目のドメイン（潜在的に疑わしいドメイン） |

#### 類似度アルゴリズム

| アルゴリズム | 説明 |
| --- | --- |
| `levenshtein` | 編集距離の正規化（0～1） |
| `jaro_winkler` | プレフィックス加重文字列の類似度 |
| `visual` | 同形文字/外観の類似文字検出 |

#### リクエスト例

```bash
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/similarity?domain1=paypal.com&domain2=paypa1.com"
```

```python
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

# 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 = domscan.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})")
```

#### レスポンス例

```json
{
  "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"]
}
```

#### レスポンスフィールド

| フィールド | タイプ |
| --- | --- |
| `domain1` | string |
| `domain2` | string |
| `overall_similarity` | number |
| `risk_level` | string |
| `analysis` | object |
| `analysis.levenshtein_distance` | integer |
| `analysis.levenshtein_similarity` | number |
| `analysis.jaro_winkler_similarity` | number |
| `analysis.visual_similarity` | number |
| `analysis.keyboard_distance` | number |
| `analysis.common_prefix_length` | integer |
| `analysis.common_suffix_length` | integer |
| `matching_methods[]` | string[] |
| `is_potential_typosquat` | boolean |
| `checked_at` | string |
| `meta` | object |