Puntuación de dominio | Documentación de la API de DomScan

GET /v1/score

Parámetros de consulta

Parámetro	Tipo	Descripción
name obligatorio	string	Dominio para calcular la puntuación
domain opcional	string	Alias de name. El parámetro name prevalece cuando se proporcionan ambos. Pase solo la etiqueta, sin TLD.

Respuesta de ejemplo

{
                "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"
                }
                }

Campos de respuesta

Campo	Tipo
`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
`feedback[]`	string[]

POST /v1/score/compare

Parámetros del cuerpo

Parámetro	Tipo	obligatorio
names	string[]	obligatorio

Campos de respuesta

Campo	Tipo
`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

Solicitud de ejemplo

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"
  ]
}'

Respuesta de ejemplo

{
  "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
  }
}

GET /v1/score/info

Campos de respuesta

Campo	Tipo
`scoring_dimensions`	object
`grade_scale`	object
`endpoints`	object

Solicitud de ejemplo

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

Respuesta de ejemplo

{
  "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"
  }
}