API الخاص بـ اقتراحات المجالات
احصل على اقتراحات أسماء مجالات مدعومة بالذكاء الاصطناعي بناءً على كلماتك الرئيسية أو علامتك التجارية أو وصف عملك. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.
العمليات
GET /v1/suggest
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
200OK401غير مصرح402الدفع مطلوب429طلبات كثيرة جداً