개발자 참고자료

도메인 검색 레시피

DomScan API로 필터링과 실시간 사용 가능 여부 확인을 제공하는 AI 기반 도메인 검색입니다.

도메인 검색 레시피

필터링과 실시간 사용 가능 여부 확인을 제공하는 AI 기반 도메인 검색입니다.

GET /v1/recipes/domain-finder

쿼리 매개변수

매개변수	유형	설명
keywords 필수	string	도메인 제안을 위한 키워드
tlds 선택 사항	string	확인할 TLD를 쉼표로 구분하여 지정(기본값: com,io,co,app)

응답 포함 항목

AI 생성 도메인 제안
실시간 사용 가능 여부
사용 가능한 도메인의 가격
각 제안의 브랜드 점수

응답 필드

필드	유형
`success`	boolean
`data`	object
`data.results[]`	object[]
`data.results[]`	object
`data.results[].domain`	string
`data.results[].available`	boolean
`data.results[].brand_score`	number
`data.results[].value_estimate`	object
`data.results[].value_estimate.low`	number
`data.results[].value_estimate.mid`	number
`data.results[].value_estimate.high`	number
`data.results[].registration_price`	number
`data.results[].best_registrar`	string
`data.results[].social_availability`	object
`data.results[].social_availability.github`	boolean
`data.results[].social_availability.twitter`	boolean
`data.results[].recommendation_score`	number
`data.results[].notes[]`	string[]
`data.filters_applied`	object
`data.filters_applied.tlds[]`	string[]
`data.filters_applied.style`	string
`data.filters_applied.max_length`	number
`data.alternatives_considered`	number
`data.search_criteria`	object
`data.search_criteria.keywords[]`	string[]
`data.search_criteria.tlds[]`	string[]
`data.search_criteria.style`	string
`data.search_criteria.max_length`	number
`data.search_criteria.budget`	object
`data.search_criteria.budget.max`	number
`data.search_criteria.budget.currency`	string
`data.search_criteria.require_social[]`	string[]
`data.search_criteria.limit`	number
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

예제 응답

{
  "success": true,
  "data": {
    "results": [
      {
        "domain": "launchgrid.com",
        "available": true,
        "brand_score": 86,
        "value_estimate": {
          "low": 400,
          "mid": 1200,
          "high": 2800
        },
        "registration_price": 10.99,
        "best_registrar": "porkbun",
        "social_availability": {
          "github": true,
          "twitter": false
        },
        "recommendation_score": 92,
        "notes": [
          "Style: brandable",
          "Within budget"
        ]
      }
    ],
    "filters_applied": {
      "tlds": [
        "com",
        "io"
      ],
      "style": "brandable",
      "max_length": 12
    },
    "alternatives_considered": 42,
    "search_criteria": {
      "keywords": [
        "launch",
        "grid"
      ],
      "tlds": [
        "com",
        "io"
      ],
      "style": "brandable",
      "max_length": 12,
      "budget": {
        "max": 20,
        "currency": "USD"
      },
      "require_social": [
        "github",
        "twitter"
      ],
      "limit": 10
    }
  },
  "meta": {
    "recipe_name": "domain-finder",
    "credits_used": 12,
    "credits_saved": 13,
    "duration_ms": 611,
    "components_called": [
      "suggest",
      "availability",
      "valuation",
      "scoring",
      "social",
      "pricing"
    ],
    "cached_components": [
      "pricing"
    ],
    "timestamp": "2026-04-15T10:11:00Z"
  },
  "errors": []
}