API الخاص بـ مقارنة المجالات
قارن عدة مجالات جنبًا إلى جنب على مقاييس مختلفة بما في ذلك التقدير والصحة وعوامل SEO. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.
العمليات
GET /v1/compare
GET
/v1/compare
الرصيد: 3
معاملات الاستعلام
| المعامل | النوع | مطلوب |
|---|---|---|
| domains | string | مطلوب |
| dry_run |
string
القيم المسموحة
true
|
اختياري |
حقول الرد
| الحقل | النوع |
|---|---|
domains[] |
object[] |
domains[] |
object |
domains[].domain |
string |
domains[].tld |
string |
domains[].available |
boolean | null |
domains[].registered_at |
string | null |
domains[].expires_at |
string | null |
domains[].valuation |
object |
domains[].valuation.estimate_usd |
number |
domains[].valuation.confidence |
number |
domains[].valuation.factors |
object |
domains[].valuation.factors.length |
integer |
domains[].valuation.factors.lengthMultiplier |
number |
domains[].valuation.factors.tld |
string |
domains[].valuation.factors.tldTier |
string |
domains[].valuation.factors.tldBase |
integer |
domains[].valuation.factors.hasHyphens |
boolean |
domains[].valuation.factors.hasNumbers |
boolean |
domains[].valuation.factors.lettersOnly |
boolean |
domains[].valuation.factors.isPremiumWord |
boolean |
domains[].valuation.factors.isDictionaryWord |
boolean |
domains[].valuation.factors.isBrandable |
boolean |
domains[].valuation.factors.isNumericPattern |
boolean |
domains[].valuation.factors.isLetterPattern |
boolean |
domains[].valuation.factors.pronounceability |
number |
domains[].valuation.factors.memorability |
number |
domains[].valuation.factors.spellingDifficulty |
number |
domains[].valuation.factors.isAcronym |
boolean |
domains[].valuation.factors.hasCommonEnding |
boolean |
domains[].valuation.factors.syllableCount |
integer |
domains[].valuation.estimate |
object |
domains[].valuation.estimate.low |
number |
domains[].valuation.estimate.mid |
number |
domains[].valuation.estimate.high |
number |
domains[].valuation.estimate.currency |
string |
domains[].valuation.analysis |
object |
domains[].valuation.analysis.scope |
string |
domains[].valuation.analysis.range_source |
string |
domains[].valuation.analysis.range_width |
string |
domains[].valuation.analysis.confidence_label |
string |
domains[].valuation.analysis.out_of_distribution |
boolean |
domains[].valuation.analysis.out_of_distribution_reasons[] |
string[] |
domains[].valuation.analysis.positive_factors[] |
string[] |
domains[].valuation.analysis.negative_factors[] |
string[] |
domains[].score |
object |
domains[].score.overall |
number |
domains[].score.length |
number |
domains[].score.pronounceability |
number |
domains[].score.memorability |
number |
domains[].score.brandability |
number |
domains[].tld_info |
object |
domains[].tld_info.type |
string |
domains[].tld_info.trust_tier |
string |
domains[].tld_info.popularity_rank |
integer | null |
domains[].recommendation_rank |
integer | null |
domains[].recommendation_reason |
string | null |
recommendation |
object |
recommendation.best_available |
string | null |
recommendation.best_overall |
string | null |
recommendation.best_value |
string | null |
recommendation.reasoning |
string |
decision_summary |
object |
decision_summary.compared_count |
integer |
decision_summary.best_overall |
string | null |
decision_summary.best_available |
string | null |
decision_summary.runner_up |
string | null |
decision_summary.rank_margin |
integer | null |
decision_summary.score_margin |
integer | null |
decision_summary.value_margin_usd |
number | null |
decision_summary.availability_used |
boolean |
decision_summary.winning_factor |
string | null |
decision_summary.tie_breaker |
string | null |
meta |
object |
meta.compared_count |
integer |
meta.available_count |
integer |
meta.total_ms |
integer |
meta.served_by |
string |
طلب مثال
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai"const response = await fetch("https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai", {
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/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai",
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/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai", 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/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai")
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))مثال الرد
{
"domains": [
{
"domain": "startup.io",
"tld": "io",
"available": true,
"valuation": {
"estimate_usd": 2500,
"confidence": 0.7,
"estimate": {
"low": 1400,
"mid": 2500,
"high": 4100,
"currency": "USD"
},
"analysis": {
"scope": "intrinsic_domain_value",
"range_source": "anchored",
"range_width": "moderate",
"confidence_label": "medium",
"out_of_distribution": false,
"out_of_distribution_reasons": [],
"positive_factors": [
"Strong .IO aftermarket demand"
],
"negative_factors": [
"Narrower buyer pool than .com"
]
}
},
"score": {
"overall": 85,
"brandability": 90
},
"tld_info": {
"type": "ccTLD",
"trust_tier": "premium",
"popularity_rank": 4
},
"recommendation_rank": 85,
"recommendation_reason": "available for registration, premium .io TLD, excellent brand score"
}
],
"recommendation": {
"best_available": "startup.io",
"best_overall": "startup.com",
"best_value": "startup.ai",
"reasoning": "startup.io is recommended: available for registration, premium .io TLD, excellent brand score"
},
"decision_summary": {
"compared_count": 3,
"best_overall": "startup.com",
"best_available": "startup.io",
"runner_up": "startup.io",
"rank_margin": 4,
"score_margin": 2,
"value_margin_usd": 1500,
"availability_used": true,
"winning_factor": "valuation",
"tie_breaker": "higher_valuation"
},
"meta": {
"compared_count": 3,
"available_count": 2,
"total_ms": 84
}
}
رموز حالة HTTP
200OK400طلب غير صالح401غير مصرح402الدفع مطلوب429طلبات كثيرة جداً