API für Domain-Score
Erhalten Sie einen umfassenden Qualitätsscore für eine Domain basierend auf mehreren Faktoren. Nutzen Sie diese Referenz, um den passenden Endpunkt zu wählen und genau zu sehen, was er zurückgibt.
Operationen
GET /v1/score
GET
/v1/score
Credits: 1
Abfrageparameter
| Parameter | Typ | erforderlich |
|---|---|---|
| name | string | optional |
| domain | string | optional |
Antwortfelder
| Feld | Typ |
|---|---|
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 |
Beispielanfrage
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))Beispielantwort
{
"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-Statuscodes
200OK400Ungültige Anfrage401Nicht autorisiert402Zahlung erforderlich429Zu viele Anfragen
POST /v1/score/compare
POST
/v1/score/compare
Credits: 2
Abfrageparameter
| Parameter | Typ | erforderlich |
|---|---|---|
| dry_run |
string
Zulässige Werte
true
|
optional |
Body-Parameter
| Parameter | Typ | erforderlich |
|---|---|---|
| names | string[] | erforderlich |
Antwortfelder
| Feld | Typ |
|---|---|
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 |
Beispielanfrage
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))Beispielantwort
{
"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-Statuscodes
200OK400Ungültige Anfrage401Nicht autorisiert402Zahlung erforderlich409HTTP 409422HTTP 422429Zu viele Anfragen
GET /v1/score/info
GET
/v1/score/info
Credits: 0
Antwortfelder
| Feld | Typ |
|---|---|
scoring_dimensions |
object |
grade_scale |
object |
endpoints |
object |
Beispielanfrage
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))Beispielantwort
{
"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-Statuscodes
200OK401Nicht autorisiert429Zu viele Anfragen