مرجع المطورين
اقتراحات المجالات
باستخدام DomScan API، احصل على اقتراحات أسماء مجالات مدعومة بالذكاء الاصطناعي بناءً على كلماتك الرئيسية أو علامتك التجارية أو وصف عملك.
اقتراحات المجالات
احصل على اقتراحات أسماء مجالات مدعومة بالذكاء الاصطناعي بناءً على كلماتك الرئيسية أو علامتك التجارية أو وصف عملك.
GET
/v1/suggest
معاملات الاستعلام
| المعامل | النوع | Description |
|---|---|---|
| keywords مطلوب | string | كلمات رئيسية مفصولة بفواصل (على سبيل المثال، "tech,cloud") |
| limit اختياري | number | الحد الأقصى للاقتراحات المرجعة (الافتراضي: 20، الحد الأقصى: 100) |
| tlds اختياري | string | النطاقات المراد استخدامها (الافتراضي: "com,ai,app") |
| style اختياري |
string
القيم المسموحة
brandablekeyword-richshortpronounceabletechyplayfulprofessionalminimal
الافتراضي
brandable
|
النمط: قابلة للعلامات التجارية وقصيرة وغنية بالكلمات الرئيسية وقابلة للنطق |
| industry اختياري |
string
القيم المسموحة
techfinancehealthecommerceeducationmediasaascryptoaigaming
|
يضيف بادئات ولواحق خاصة بالصناعة إلى المرشحين المُنتجة. |
| language اختياري |
string
القيم المسموحة
enzhesjadefrptitkoruarhibnidmsthvitrplnlsvdanofielcshuroukhe
الافتراضي
en
|
يُنتج بادئات ولواحق للغة المختارة إلى جانب الافتراضيات الإنجليزية. |
| check اختياري |
boolean
القيم المسموحة
truefalse
الافتراضي
true
|
اضبط على false لتخطي البحث عن التوفر وإرجاع الأسماء المُنتجة فقط. |
طلب مثال
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/suggest?keywords=cloud,sync&limit=10&style=brandable"
const domscanFetch = (url, options = {}) =>
fetch(url, {
...options,
headers: { ...options.headers, "X-API-Key": "your-api-key" },
});
const params = new URLSearchParams({
keywords: "cloud,sync",
limit: "10",
style: "brandable"
});
const response = await domscanFetch("https://domscan.net/v1/suggest?" + params);
console.log(await response.json());
import requests
domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})
params = {"keywords": "cloud,sync", "limit": 10, "style": "brandable"}
data = domscan.get("https://domscan.net/v1/suggest", params=params).json()
print(data["suggestions"])
package main
import (
"encoding/json"
"fmt"
"net/http"
"os"
)
func domscanGet(url string) (*http.Response, error) {
request, err := http.NewRequest(http.MethodGet, url, nil)
if err != nil {
return nil, err
}
request.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
return http.DefaultClient.Do(request)
}
func main() {
url := "https://domscan.net/v1/suggest?keywords=cloud,sync&limit=10&style=brandable"
resp, _ := domscanGet(url)
defer resp.Body.Close()
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)
fmt.Println(data["suggestions"])
}
require 'net/http'
require 'json'
uri = URI("https://domscan.net/v1/suggest?keywords=cloud,sync&limit=10&style=brandable")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
data = JSON.parse(response.body)
puts data["suggestions"]
مثال الرد
{
"suggestions": [
{
"name": "cloudsync",
"domain": "cloudsync.io",
"tld": "io",
"score": 95,
"styles": ["brandable", "pronounceable"],
"method": "combination",
"available": true
}
],
"keywords": ["cloud", "sync"],
"generated_count": 10,
"available_count": 4
}
حقول الرد
| الحقل | النوع |
|---|---|
suggestions[] |
object[] |
suggestions[] |
object |
suggestions[].name |
string |
suggestions[].domain |
string |
suggestions[].tld |
string |
suggestions[].score |
integer |
suggestions[].available |
boolean | null |
suggestions[].method |
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 |