개발자 참고자료

도메인 점수 API 문서

도메인 점수 API 문서: 여러 요소를 기반으로 전체 도메인 품질 점수를 계산합니다.

도메인 점수

여러 요소를 기반으로 전체 도메인 품질 점수를 계산합니다.

GET /v1/score

쿼리 매개변수

매개변수	유형	설명
name 필수	string	점수를 계산할 도메인

예제 응답

{
                "success": true,
                "data": {
                "name": "startup",
                "overall_score": 82,
                "grade": "B+",
                "scores": {
                "length": 86,
                "pronounceability": 78,
                "memorability": 80,
                "spelling": 84,
                "uniqueness": 75,
                "brandability": 88
                },
                "analysis": {
                "length": 7,
                "syllable_count": 2,
                "has_vowels": true,
                "has_numbers": false,
                "has_hyphens": false
                }
                },
                "meta": {
                "requestId": "req_demo"
                }
                }

응답 필드

필드	유형
`name`	string
`overall_score`	integer
`grade`	string
`scores`	object
`scores.length`	integer
`scores.pronounceability`	integer
`scores.memorability`	integer
`scores.spelling`	integer
`scores.uniqueness`	integer
`feedback[]`	string[]

POST /v1/score/compare

본문 매개변수

매개변수	유형	필수
names	string[]	필수

응답 필드

필드	유형
`names[]`	object[]
`names[]`	object
`best`	string \| null
`ranking[]`	object[]
`ranking[]`	object
`ranking[].name`	string
`ranking[].score`	number
`ranking[].rank`	integer
`meta`	object
`meta.total_compared`	integer
`meta.valid_scores`	integer

예제 요청

curl -X POST "https://domscan.net/v1/score/compare" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "names": [
    "brandify",
    "brandpilot",
    "brandmint"
  ]
}'

예제 응답

{
  "names": [
    {
      "name": "brandify",
      "score": 88,
      "grade": "A",
      "verdict": "Strong"
    },
    {
      "name": "brandpilot",
      "score": 82,
      "grade": "B+",
      "verdict": "Promising"
    }
  ],
  "best": "brandify",
  "ranking": [
    {
      "name": "brandify",
      "score": 88,
      "rank": 1
    },
    {
      "name": "brandpilot",
      "score": 82,
      "rank": 2
    }
  ],
  "meta": {
    "total_compared": 2,
    "valid_scores": 2
  }
}

GET /v1/score/info

응답 필드

필드	유형
`scoring_dimensions`	object
`grade_scale`	object
`endpoints`	object

예제 요청

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/score/info"

예제 응답

{
  "scoring_dimensions": {
    "length": {
      "weight": 0.12,
      "description": "Rewards concise names"
    },
    "pronounceability": {
      "weight": 0.18,
      "description": "Rewards names that are easy to say"
    }
  },
  "grade_scale": {
    "A+": "Exceptional",
    "A": "Excellent",
    "B": "Good",
    "C": "Average",
    "D": "Weak",
    "F": "Poor"
  },
  "endpoints": {
    "GET /v1/score?name=<name>": "Score a single name",
    "POST /v1/score/compare": "Compare multiple names",
    "GET /v1/score/info": "Get scoring methodology"
  }
}