API referansı

Domain Önerileri API ürünü

Anahtar kelimelerinize, markanıza veya işletme açıklamasına dayalı yapay zeka destekli alan adı önerileri alın. Doğru uç noktayı seçmek ve tam olarak ne döndürdüğünü görmek için bu referansı kullanın.

İşlemler

GET /v1/suggest

İşlem: suggestDomains Krediler ve kimlik doğrulama: 2-5 Kimlik doğrulama gerekli
GET /v1/suggest Kredi: 2-5

Sorgu parametreleri

Parametre Tür gerekli
keywords string gerekli
tlds string isteğe bağlı
style string
İzin verilen değerler brandablekeyword-richshortpronounceabletechyplayfulprofessionalminimal
Varsayılan brandable
isteğe bağlı
industry string
İzin verilen değerler techfinancehealthecommerceeducationmediasaascryptoaigaming
isteğe bağlı
language string
İzin verilen değerler enzhesjadefrptitkoruarhibnidmsthvitrplnlsvdanofielcshuroukhe
Varsayılan en
isteğe bağlı
limit integer
Varsayılan 20
isteğe bağlı
check boolean
Varsayılan true
isteğe bağlı

Yanıt alanları

Alan Tür
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

Örnek istek

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

Örnek yanıt

{
  "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 durum kodları

  • 200 OK
  • 401 Yetkisiz
  • 402 Ödeme Gerekli
  • 429 Çok Fazla İstek

Referans kaynakları