ذكاء النطاقات · منتج DomScan

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

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

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

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

غير متزامنRESTMCPSDK

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

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

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

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

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

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

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

نقاط النهاية

اطّلع على ما تقبله كل نقطة نهاية وما تعيده وأوضاعها وحدودها قبل التكامل.

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

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

1 المصادقة مطلوبة. راجع مرجع API لمعرفة التكلفة الدقيقة، بما في ذلك أي تسعير لكل عنصر.

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

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

POST /v1/domain-discovery/jobs الرصيد: 1/item

معاملات متن الطلب

المعامل النوع مطلوب
notify_webhook unknown اختياري
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
}'
const response = await fetch("https://domscan.net/v1/domain-discovery/jobs", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "tlds": [
      "io",
      "ai"
    ],
    "limit": 50,
    "min_length": 4,
    "max_length": 8,
    "singular_only": true
  }),
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.post(
    "https://domscan.net/v1/domain-discovery/jobs",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "tlds": [
            "io",
            "ai",
        ],
        "limit": 50,
        "min_length": 4,
        "max_length": 8,
        "singular_only": True,
    },
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	body := strings.NewReader(`{
	  "tlds": [
	    "io",
	    "ai"
	  ],
	  "limit": 50,
	  "min_length": 4,
	  "max_length": 8,
	  "singular_only": true
	}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/domain-discovery/jobs", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	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/domain-discovery/jobs")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "tlds" => [
    "io",
    "ai"
  ],
  "limit" => 50,
  "min_length" => 4,
  "max_length" => 8,
  "singular_only" => true
})

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))

مثال الرد

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

رموز حالة HTTP

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

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

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

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

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

غير معروف أو جزئي يعني أننا لم نتمكن من تأكيد النتيجة بالكامل. ضع الحالة ومستوى الثقة وحداثة البيانات وأي حدود في اعتبارك عند التصرف بناءً عليها.

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

يعتمد السعر على الفحص والوضع الذي تختاره. يعرض مرجع API تكلفة الأرصدة الحالية، وما إذا كنت تحتاج إلى مفتاح API، وأي تسعير لكل عنصر.

يستخدمه أشخاص في هذه الشركات

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse