مرجع API

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

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

العمليات

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

GET /v1/suggest

العملية: suggestDomains الوحدات والمصادقة: 2-5 المصادقة مطلوبة
GET /v1/suggest الرصيد: 2-5

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

المعامل النوع مطلوب
keywords string مطلوب
tlds string اختياري
style string
القيم المسموحة brandablekeyword-richshortpronounceabletechyplayfulprofessionalminimal
الافتراضي brandable
اختياري
industry string
القيم المسموحة techfinancehealthecommerceeducationmediasaascryptoaigaming
اختياري
language string
القيم المسموحة enzhesjadefrptitkoruarhibnidmsthvitrplnlsvdanofielcshuroukhe
الافتراضي en
اختياري
limit integer
الافتراضي 20
اختياري
check boolean
الافتراضي true
اختياري

حقول الرد

الحقل النوع
suggestions[] object[]
suggestions[] object
suggestions[].name string
suggestions[].domain string
suggestions[].tld string
suggestions[].score integer
suggestions[].available boolean | null
suggestions[].method string
suggestions[].styles[] string[]
suggestions[].checked_at string
keywords[] string[]
tlds[] string[]
styles[] string[]
industry string | null
language string
generated_count integer
available_count integer | null
generation_summary object
generation_summary.requested_limit integer
generation_summary.candidate_count integer
generation_summary.returned_count integer
generation_summary.availability_checked boolean
generation_summary.availability_check_count integer
generation_summary.available_count integer | null
generation_summary.tld_count integer
generation_summary.language string
generation_summary.method_counts object
generation_summary.style_counts object
generation_summary.top_method string | null
generation_summary.average_score integer | null
meta object
meta.total_generated integer
meta.available_count integer
meta.generation_ms integer
meta.availability_check_ms integer
meta.total_ms integer
meta.served_by string

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true"
const response = await fetch("https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true", {
  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/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true",
    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/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true", 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/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=brandable&industry=tech&language=es&limit=25&check=true")
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))

مثال الرد

{
  "suggestions": [
    {
      "name": "brandpilot",
      "domain": "brandpilot.io",
      "tld": "io",
      "score": 86,
      "available": true,
      "method": "combination"
    },
    {
      "name": "getbrand",
      "domain": "getbrand.com",
      "tld": "com",
      "score": 78,
      "available": false,
      "method": "prefix"
    },
    {
      "name": "pilotbrand",
      "domain": "pilotbrand.ai",
      "tld": "ai",
      "score": 74,
      "available": null,
      "method": "combination"
    }
  ],
  "keywords": [
    "brand",
    "pilot"
  ],
  "tlds": [
    "com",
    "io",
    "ai"
  ],
  "styles": [
    "brandable",
    "keyword-rich",
    "short",
    "pronounceable"
  ],
  "language": "en",
  "generated_count": 12,
  "available_count": 4,
  "generation_summary": {
    "requested_limit": 3,
    "candidate_count": 12,
    "returned_count": 3,
    "availability_checked": true,
    "availability_check_count": 9,
    "available_count": 4,
    "tld_count": 3,
    "language": "en",
    "method_counts": {
      "combination": 2,
      "prefix": 1
    },
    "style_counts": {
      "brandable": 2,
      "keyword-rich": 2,
      "pronounceable": 1
    },
    "top_method": "combination",
    "average_score": 79
  },
  "meta": {
    "generation_ms": 6
  }
}

رموز حالة HTTP

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

موارد المرجع