개발자 참고자료

도메인 제안

DomScan API로 키워드, 브랜드 또는 비즈니스 설명을 기반으로 AI 기반 도메인 이름 제안을 받습니다.

도메인 제안

키워드, 브랜드 또는 비즈니스 설명을 기반으로 AI 기반 도메인 이름 제안을 받습니다.

GET /v1/suggest

쿼리 매개변수

매개변수유형설명
keywords 필수 string 쉼표로 구분된 키워드(예: "tech,cloud")
limit 선택 사항 number 반환할 최대 제안 수(기본값: 20, 최대: 100)
tlds 선택 사항 string 사용할 TLD(기본값: "com,ai,app")
style 선택 사항 string 스타일: 브랜드 능력, 짧음, 키워드 풍부, 발음 가능

예제 요청

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[]
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