مرجع API

API الخاص بـ مقارنة المجالات

قارن عدة مجالات جنبًا إلى جنب على مقاييس مختلفة بما في ذلك التقدير والصحة وعوامل SEO. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.

العمليات

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

GET /v1/compare

العملية: compareDomains الوحدات والمصادقة: 3 المصادقة مطلوبة
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

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

موارد المرجع