مرجع API

API الخاص بـ تشابه المجالات

ابحث عن مجالات مماثلة لمجال معين بناءً على أنماط الأسماء والكلمات الرئيسية. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.

العمليات

GET /v1/similarity عرض مرجع API

GET /v1/similarity

العملية: getDomainSimilarity الوحدات والمصادقة: 2 المصادقة مطلوبة
GET /v1/similarity الرصيد: 2

معاملات الاستعلام

المعامل النوع مطلوب
domain1 string مطلوب
domain2 string مطلوب

حقول الرد

الحقل النوع
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

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org"
const response = await fetch("https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

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

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org", 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))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org")
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))

مثال الرد

{
  "domain1": "example.com",
  "domain2": "exampel.com",
  "overall_similarity": 79,
  "risk_level": "medium",
  "analysis": {
    "levenshtein_distance": 2,
    "levenshtein_similarity": 71,
    "jaro_winkler_similarity": 97,
    "visual_similarity": 71,
    "keyboard_distance": 6.08,
    "common_prefix_length": 5,
    "common_suffix_length": 0
  },
  "matching_methods": [
    "jaro-winkler",
    "common-prefix",
    "same-tld"
  ],
  "is_potential_typosquat": true,
  "checked_at": "2026-10-09T10:15:30.000Z",
  "meta": {
    "served_by": "pop=MAD country=ES"
  }
}

رموز حالة HTTP

  • 200 OK
  • 400 طلب غير صالح
  • 401 غير مصرح
  • 402 الدفع مطلوب
  • 429 طلبات كثيرة جداً

موارد المرجع