도메인 점수 API 레퍼런스
여러 요소를 기반으로 한 도메인의 종합 품질 점수를 받습니다. 이 레퍼런스에서 알맞은 엔드포인트를 고르고 반환되는 결과를 정확히 확인하세요.
작업
GET /v1/score
GET
/v1/score
크레딧: 1
쿼리 매개변수
| 매개변수 | 유형 | 필수 |
|---|---|---|
| name | string | 선택 사항 |
| domain | string | 선택 사항 |
응답 필드
| 필드 | 유형 |
|---|---|
name |
string |
input |
string |
scored_label |
string |
tld |
string |
overall_score |
integer |
grade |
string |
scores |
object |
scores.length |
integer |
scores.pronounceability |
number |
scores.memorability |
integer |
scores.spelling |
integer |
scores.uniqueness |
integer |
scores.brandability |
integer |
score_explanation |
object |
score_explanation.score_band |
string |
score_explanation.top_strengths[] |
object[] |
score_explanation.top_strengths[] |
object |
score_explanation.top_strengths[].dimension |
string |
score_explanation.top_strengths[].score |
number |
score_explanation.top_strengths[].weight |
number |
score_explanation.top_blockers[] |
object[] |
score_explanation.top_blockers[] |
object |
score_explanation.top_blockers[].dimension |
string |
score_explanation.top_blockers[].score |
number |
score_explanation.top_blockers[].weight |
number |
score_explanation.weighted_dimensions |
object |
score_explanation.most_sensitive_dimension |
string |
score_explanation.points_to_next_grade |
integer | null |
analysis |
object |
analysis.syllable_count |
integer |
analysis.character_count |
integer |
analysis.has_vowels |
boolean |
analysis.has_numbers |
boolean |
analysis.has_hyphens |
boolean |
analysis.is_dictionary_word |
boolean |
analysis.is_premium_word |
boolean |
analysis.is_too_generic |
boolean |
analysis.starts_with_vowel |
boolean |
analysis.ends_with_vowel |
boolean |
analysis.has_repeated_letters |
boolean |
analysis.vowel_ratio |
number |
recommendations[] |
string[] |
available_tlds[] |
string[] |
feedback[] |
string[] |
meta |
object |
meta.methodology |
string |
meta.disclaimer |
string |
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/score?name=brandify&domain=brandify.com"const response = await fetch("https://domscan.net/v1/score?name=brandify&domain=brandify.com", {
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/score?name=brandify&domain=brandify.com",
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/score?name=brandify&domain=brandify.com", 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/score?name=brandify&domain=brandify.com")
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))예제 응답
{
"name": "brandpilot",
"input": "brandpilot.io",
"scored_label": "brandpilot",
"tld": "io",
"overall_score": 73,
"grade": "B",
"scores": {
"length": 60,
"pronounceability": 68.33,
"memorability": 65,
"spelling": 80,
"uniqueness": 65,
"brandability": 95
},
"score_explanation": {
"score_band": "strong",
"top_strengths": [
{
"dimension": "brandability",
"score": 95,
"weight": 0.2
},
{
"dimension": "memorability",
"score": 65,
"weight": 0.2
},
{
"dimension": "pronounceability",
"score": 68.33,
"weight": 0.18
}
],
"top_blockers": [
{
"dimension": "length",
"score": 60,
"weight": 0.12
},
{
"dimension": "memorability",
"score": 65,
"weight": 0.2
},
{
"dimension": "uniqueness",
"score": 65,
"weight": 0.15
}
],
"weighted_dimensions": {
"length": {
"score": 60,
"weight": 0.12,
"weighted_points": 7
},
"pronounceability": {
"score": 68.33,
"weight": 0.18,
"weighted_points": 12
},
"memorability": {
"score": 65,
"weight": 0.2,
"weighted_points": 13
},
"spelling": {
"score": 80,
"weight": 0.15,
"weighted_points": 12
},
"uniqueness": {
"score": 65,
"weight": 0.15,
"weighted_points": 10
},
"brandability": {
"score": 95,
"weight": 0.2,
"weighted_points": 19
}
},
"most_sensitive_dimension": "memorability",
"points_to_next_grade": 7
}
}
HTTP 상태 코드
200성공400잘못된 요청401인증되지 않음402결제 필요429요청 과다
POST /v1/score/compare
POST
/v1/score/compare
크레딧: 2
쿼리 매개변수
| 매개변수 | 유형 | 필수 |
|---|---|---|
| dry_run |
string
허용된 값
true
|
선택 사항 |
본문 매개변수
| 매개변수 | 유형 | 필수 |
|---|---|---|
| names | string[] | 필수 |
응답 필드
| 필드 | 유형 |
|---|---|
names[] |
object[] |
names[] |
object |
best |
string | null |
ranking[] |
object[] |
ranking[] |
object |
ranking[].name |
string |
ranking[].score |
number |
ranking[].rank |
integer |
decision_summary |
object |
decision_summary.compared_count |
integer |
decision_summary.best |
string | null |
decision_summary.runner_up |
string | null |
decision_summary.score_margin |
integer | null |
decision_summary.score_spread |
integer |
decision_summary.tie_breaker |
string | null |
decision_summary.winning_dimension |
string | null |
meta |
object |
meta.total_compared |
integer |
meta.valid_scores |
integer |
meta.duplicates_removed |
integer |
예제 요청
curl -X POST "https://domscan.net/v1/score/compare" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"names": [
"brandpilot",
"launchly",
"nimbus"
]
}'const response = await fetch("https://domscan.net/v1/score/compare", {
method: "POST",
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"names": [
"brandpilot",
"launchly",
"nimbus"
]
}),
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.post(
"https://domscan.net/v1/score/compare",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
json={
"names": [
"brandpilot",
"launchly",
"nimbus",
],
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"names": [
"brandpilot",
"launchly",
"nimbus"
]
}`)
req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/score/compare", body)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
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/score/compare")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
"names" => [
"brandpilot",
"launchly",
"nimbus"
]
})
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))예제 응답
{
"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
}
],
"decision_summary": {
"compared_count": 2,
"best": "brandify",
"runner_up": "brandpilot",
"score_margin": 6,
"score_spread": 6,
"tie_breaker": "higher_brandability",
"winning_dimension": "brandability"
},
"meta": {
"total_compared": 2,
"valid_scores": 2
}
}
HTTP 상태 코드
200성공400잘못된 요청401인증되지 않음402결제 필요409HTTP 409422HTTP 422429요청 과다
GET /v1/score/info
GET
/v1/score/info
크레딧: 0
응답 필드
| 필드 | 유형 |
|---|---|
scoring_dimensions |
object |
grade_scale |
object |
endpoints |
object |
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/score/info"const response = await fetch("https://domscan.net/v1/score/info", {
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/score/info",
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/score/info", 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/score/info")
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))예제 응답
{
"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"
}
}
HTTP 상태 코드
200성공401인증되지 않음429요청 과다