منتج API الخاص بـ وصفة البحث عن النطاق

ما الذي تحصل عليه

ضع العديد من طلبات API المدعومة في قائمة انتظار واجمع نتائجها من دون إبقاء اتصال العميل مفتوحاً.

غير متزامنRESTMCPSDK

اختر هذا المنتج عندما

لمن صُمم هذا المنتج

استخدم فحوصات مركّزة لقرار واحد، أو أنشئ ملفًا أوسع عندما يكون السياق مهمًا.

اختر هذا المنتج عندما

اختره لفحص تركيبات من مجموعة كلمات إنجليزية مفردة عبر 1 إلى 5 TLDs، بما يصل إلى 100 فحص للكلمات وTLD لكل مهمة.

ما الذي تحصل عليه

ضع العديد من طلبات API المدعومة في قائمة انتظار واجمع نتائجها من دون إبقاء اتصال العميل مفتوحاً.

نقاط النهاية

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

POST /v1/domain-discovery/jobs عرض مرجع API

الوحدات والمصادقة

1 المصادقة مطلوبة. راجع مرجع العملية لمعرفة التكلفة الدقيقة وتسعير كل عنصر إن وُجد.

مثال على عملية

استخدم العمليات الموثقة لجمع الأدلة العامة أو تقييمها أو إثرائها أو التحقق منها أو مقارنتها أو حمايتها أو مراقبتها.

POST /v1/domain-discovery/jobs

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

المعامل	النوع	مطلوب
tlds	string[]	مطلوب
limit	integer	اختياري
cursor	string	اختياري
min_length	integer الافتراضي `3`	اختياري
max_length	integer الافتراضي `16`	اختياري
singular_only	boolean الافتراضي `false`	اختياري

حقول الرد

الحقل	النوع
`job`	object
`job.id`	string
`job.status`	string
`job.total`	integer
`job.counts`	object
`job.counts.pending`	integer
`job.counts.processing`	integer
`job.counts.succeeded`	integer
`job.counts.failed`	integer
`job.counts.cancelled`	integer
`job.billing`	object
`job.billing.credits_charged`	integer
`job.billing.credits_refunded`	integer
`job.billing.credits_net`	integer
`job.webhook`	object
`job.webhook.configured`	boolean
`job.webhook.status`	string
`job.webhook.attempts`	integer
`job.status_url`	string
`job.results_url`	string
`job.results_csv_url`	string
`job.poll_after_ms`	integer \| null
`job.created_at`	string
`job.started_at`	string \| null
`job.completed_at`	string \| null
`job.cancelled_at`	string \| null
`job.updated_at`	string
`job.processing_deadline_at`	string
`job.results_expires_at`	string
`discovery`	object
`discovery.corpus`	string
`discovery.corpus_version`	string
`discovery.total_matching_words`	integer
`discovery.page_offset`	integer
`discovery.page_words`	integer
`discovery.domain_checks`	integer
`discovery.tlds[]`	string[]
`discovery.filters`	object
`discovery.filters.min_length`	integer
`discovery.filters.max_length`	integer
`discovery.filters.singular_only`	boolean
`discovery.credits_per_domain`	integer
`discovery.next_cursor`	string \| null

طلب مثال

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "tlds": [
    "io",
    "ai"
  ],
  "limit": 50,
  "min_length": 4,
  "max_length": 8,
  "singular_only": true
}'

مثال الرد

{
  "job": {
    "id": "example-id",
    "status": "queued",
    "total": 1,
    "counts": {
      "pending": 1,
      "processing": 1,
      "succeeded": 1,
      "failed": 1,
      "cancelled": 1
    },
    "billing": {
      "credits_charged": 1,
      "credits_refunded": 1,
      "credits_net": 1
    },
    "webhook": {
      "configured": false,
      "status": "not_configured",
      "attempts": 1
    },
    "status_url": "https://example.com",
    "results_url": "https://example.com",
    "results_csv_url": "https://example.com",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z",
    "processing_deadline_at": "2026-08-27T12:00:00Z",
    "results_expires_at": "2026-08-27T12:00:00Z",
    "poll_after_ms": 1,
    "started_at": "2026-08-27T12:00:00Z",
    "completed_at": "2026-08-27T12:00:00Z",
    "cancelled_at": "2026-08-27T12:00:00Z"
  },
  "discovery": {
    "corpus": "iannuttall/unclaimed",
    "corpus_version": "example",
    "total_matching_words": 1,
    "page_offset": 1,
    "page_words": 1,
    "domain_checks": 1,
    "tlds": [
      "com",
      "net",
      "org"
    ],
    "filters": {
      "min_length": 1,
      "max_length": 1,
      "singular_only": false
    },
    "credits_per_domain": 1,
    "next_cursor": "example"
  }
}

الحدود وحدود الأدلة

تعيد المهام غير المتزامنة معرّفًا لمتابعة الحالة واسترداد النتائج لاحقًا.

تعالج العمليات المجمعة مدخلات متعددة مع الحفاظ على النتائج الموثقة لكل عنصر.

تعني الحالة الجزئية اكتمال بعض العناصر أو المكونات المطلوبة دون غيرها.

تظل التغطية محدودة بالمدخلات والميزانيات والمصادر وحدود الاستجابة الموثقة.

لا تثبت نتيجة الغياب أو عدم المعرفة إمكانية المطالبة بالمعرّف أو تسجيله.

تمت المراجعة في 2026-08-22

منتجات ذات صلة

الأسئلة الشائعة

أين أجد مرجع طلب واستجابة وصفة البحث عن النطاق؟

استخدم مرجع API الخاص بـ وصفة البحث عن النطاق لمراجعة المعاملات وحقول الاستجابة والأمثلة ورموز الحالة وأنماط التشغيل المدعومة.

كيف أفسر النتائج غير المعروفة أو غير المكتملة من وصفة البحث عن النطاق؟

تعني النتائج غير المعروفة أو الجزئية أن الأدلة المطلوبة لم تُحسم بالكامل. احتفظ بحالة النتيجة ومستوى الثقة والحداثة والحدود عند اتخاذ القرارات اللاحقة.

كيف يتم احتساب سعر وصفة البحث عن النطاق؟

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