مرجع API

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

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

عرض صفحة المنتج

العمليات

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

GET `/v1/compare`

العملية: compareDomains الوحدات والمصادقة: 3 المصادقة مطلوبة

GET /v1/compare

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

المعامل	النوع	مطلوب
domains	string	مطلوب

حقول الرد

الحقل	النوع
`domains[]`	object[]
`domains[]`	object
`domains[].domain`	string
`domains[].tld`	string
`domains[].available`	boolean
`domains[].registered_at`	string \| null
`domains[].expires_at`	string \| null
`domains[].valuation`	object
`domains[].valuation.estimate_usd`	number
`domains[].valuation.confidence`	number
`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

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai"

مثال الرد

{
  "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
  }
}

موارد المرجع

OpenAPI 3.0 Postman MCP