開発者向けリファレンス
ドメイン スコア 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"
}
}
