مرجع المطورين

وصفة مكتشف النطاق

باستخدام DomScan API، اكتشاف نطاق مدعوم بالذكاء الاصطناعي مع التصفية وفحص التوفر في الوقت الفعلي.

وصفة مكتشف النطاق

اكتشاف نطاق مدعوم بالذكاء الاصطناعي مع التصفية وفحص التوفر في الوقت الفعلي.

GET /v1/recipes/domain-finder

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

المعامل	النوع	Description
keywords مطلوب	string	كلمات مفتاحية لاقتراحات النطاق
tlds اختياري	string	TLDs مفصولة بفواصل (الافتراضي: com,io,co,app)
style اختياري	string القيم المسموحة `brandablekeyword-richshort`	نمط الأسماء المستخدم لإنشاء المرشحين.
max_length اختياري	integer	أطول label نطاق للإرجاع، من 2 إلى 63 حرفاً. TLD لا يُحتسب.
language اختياري	string القيم المسموحة `enzhesjadefrptitkoruarhibnidmsthvitrplnlsvdanofielcshuroukhe` الافتراضي `en`	يُنتج مرشحين للغة المختارة إلى جانب الافتراضيات الإنجليزية.
limit اختياري	integer	الاقتراحات المراد إرجاعها، من 1 إلى 50.

تتضمن الاستجابة

اقتراحات نطاقات مولدة بالذكاء الاصطناعي
حالة التوفر الفعلية
التسعير للنطاقات المتاحة
درجة العلامة التجارية لكل اقتراح

حقول الرد

الحقل	النوع
`success`	boolean
`data`	object
`data.results[]`	object[]
`data.results[]`	object
`data.results[].domain`	string
`data.results[].available`	boolean
`data.results[].brand_score`	number
`data.results[].value_estimate`	object
`data.results[].value_estimate.low`	number
`data.results[].value_estimate.mid`	number
`data.results[].value_estimate.high`	number
`data.results[].registration_price`	number
`data.results[].best_registrar`	string
`data.results[].social_availability`	object
`data.results[].social_availability.github`	boolean
`data.results[].social_availability.twitter`	boolean
`data.results[].recommendation_score`	number
`data.results[].notes[]`	string[]
`data.filters_applied`	object
`data.filters_applied.tlds[]`	string[]
`data.filters_applied.style`	string
`data.filters_applied.max_length`	number
`data.alternatives_considered`	number
`data.search_criteria`	object
`data.search_criteria.keywords[]`	string[]
`data.search_criteria.tlds[]`	string[]
`data.search_criteria.style`	string
`data.search_criteria.max_length`	number
`data.search_criteria.budget`	object
`data.search_criteria.budget.max`	number
`data.search_criteria.budget.currency`	string
`data.search_criteria.require_social[]`	string[]
`data.search_criteria.limit`	number
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

مثال الرد

{
  "success": true,
  "data": {
    "results": [
      {
        "domain": "launchgrid.com",
        "available": true,
        "brand_score": 86,
        "value_estimate": {
          "low": 400,
          "mid": 1200,
          "high": 2800
        },
        "registration_price": 10.99,
        "best_registrar": "porkbun",
        "social_availability": {
          "github": true,
          "twitter": false
        },
        "recommendation_score": 92,
        "notes": [
          "Style: brandable",
          "Within budget"
        ]
      }
    ],
    "filters_applied": {
      "tlds": [
        "com",
        "io"
      ],
      "style": "brandable",
      "max_length": 12
    },
    "alternatives_considered": 42,
    "search_criteria": {
      "keywords": [
        "launch",
        "grid"
      ],
      "tlds": [
        "com",
        "io"
      ],
      "style": "brandable",
      "max_length": 12,
      "budget": {
        "max": 20,
        "currency": "USD"
      },
      "require_social": [
        "github",
        "twitter"
      ],
      "limit": 10
    }
  },
  "meta": {
    "recipe_name": "domain-finder",
    "credits_used": 12,
    "credits_saved": 13,
    "duration_ms": 611,
    "components_called": [
      "suggest",
      "availability",
      "valuation",
      "scoring",
      "social",
      "pricing"
    ],
    "cached_components": [
      "pricing"
    ],
    "timestamp": "2026-04-15T10:11:00Z"
  },
  "errors": []
}