> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/pt/docs/products/domain-compare

# API de Comparação de Domínios

Compare vários domínios lado a lado em várias métricas incluindo avaliação, saúde e factores de SEO. Use esta referência para escolher o endpoint certo e ver exatamente o que ele retorna.

[Ver página do produto](https://domscan.net/pt/domain-compare)

## Operações

GET `/v1/compare` [Ver referência da API](https://domscan.net/pt/docs/products/domain-compare#compareDomains)

## GET `/v1/compare`

Operação: `compareDomains`
Créditos e autenticação: 3
Autenticação obrigatória

GET /v1/compare Créditos: 3

#### Parâmetros de consulta

| Parâmetro | Tipo | obrigatório |
| --- | --- | --- |
| domains | string | obrigatório |
| dry_run | string Valores permitidos `true` | opcional |

#### Campos da resposta

| Campo | Tipo |
| --- | --- |
| `domains[]` | object[] |
| `domains[]` | object |
| `domains[].domain` | string |
| `domains[].tld` | string |
| `domains[].available` | boolean \| null |
| `domains[].registered_at` | string \| null |
| `domains[].expires_at` | string \| null |
| `domains[].valuation` | object |
| `domains[].valuation.estimate_usd` | number |
| `domains[].valuation.confidence` | number |
| `domains[].valuation.factors` | object |
| `domains[].valuation.factors.length` | integer |
| `domains[].valuation.factors.lengthMultiplier` | number |
| `domains[].valuation.factors.tld` | string |
| `domains[].valuation.factors.tldTier` | string |
| `domains[].valuation.factors.tldBase` | integer |
| `domains[].valuation.factors.hasHyphens` | boolean |
| `domains[].valuation.factors.hasNumbers` | boolean |
| `domains[].valuation.factors.lettersOnly` | boolean |
| `domains[].valuation.factors.isPremiumWord` | boolean |
| `domains[].valuation.factors.isDictionaryWord` | boolean |
| `domains[].valuation.factors.isBrandable` | boolean |
| `domains[].valuation.factors.isNumericPattern` | boolean |
| `domains[].valuation.factors.isLetterPattern` | boolean |
| `domains[].valuation.factors.pronounceability` | number |
| `domains[].valuation.factors.memorability` | number |
| `domains[].valuation.factors.spellingDifficulty` | number |
| `domains[].valuation.factors.isAcronym` | boolean |
| `domains[].valuation.factors.hasCommonEnding` | boolean |
| `domains[].valuation.factors.syllableCount` | integer |
| `domains[].valuation.estimate` | object |
| `domains[].valuation.estimate.low` | number |
| `domains[].valuation.estimate.mid` | number |
| `domains[].valuation.estimate.high` | number |
| `domains[].valuation.estimate.currency` | string |
| `domains[].valuation.analysis` | object |
| `domains[].valuation.analysis.scope` | string |
| `domains[].valuation.analysis.range_source` | string |
| `domains[].valuation.analysis.range_width` | string |
| `domains[].valuation.analysis.confidence_label` | string |
| `domains[].valuation.analysis.out_of_distribution` | boolean |
| `domains[].valuation.analysis.out_of_distribution_reasons[]` | string[] |
| `domains[].valuation.analysis.positive_factors[]` | string[] |
| `domains[].valuation.analysis.negative_factors[]` | string[] |
| `domains[].score` | object |
| `domains[].score.overall` | number |
| `domains[].score.length` | number |
| `domains[].score.pronounceability` | number |
| `domains[].score.memorability` | number |
| `domains[].score.brandability` | number |
| `domains[].tld_info` | object |
| `domains[].tld_info.type` | string |
| `domains[].tld_info.trust_tier` | string |
| `domains[].tld_info.popularity_rank` | integer \| null |
| `domains[].recommendation_rank` | integer \| null |
| `domains[].recommendation_reason` | string \| null |
| `recommendation` | object |
| `recommendation.best_available` | string \| null |
| `recommendation.best_overall` | string \| null |
| `recommendation.best_value` | string \| null |
| `recommendation.reasoning` | string |
| `decision_summary` | object |
| `decision_summary.compared_count` | integer |
| `decision_summary.best_overall` | string \| null |
| `decision_summary.best_available` | string \| null |
| `decision_summary.runner_up` | string \| null |
| `decision_summary.rank_margin` | integer \| null |
| `decision_summary.score_margin` | integer \| null |
| `decision_summary.value_margin_usd` | number \| null |
| `decision_summary.availability_used` | boolean |
| `decision_summary.winning_factor` | string \| null |
| `decision_summary.tie_breaker` | string \| null |
| `meta` | object |
| `meta.compared_count` | integer |
| `meta.available_count` | integer |
| `meta.total_ms` | integer |
| `meta.served_by` | string |

#### Exemplo de requisição

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai"
```

```javascript
const response = await fetch("https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai", 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))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/compare?domains=startup.com%2Cstartup.io%2Cstartup.ai")
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))
```

#### Exemplo de resposta

```json
{
  "domains": [
    {
      "domain": "startup.io",
      "tld": "io",
      "available": true,
      "valuation": {
        "estimate_usd": 2500,
        "confidence": 0.7,
        "estimate": {
          "low": 1400,
          "mid": 2500,
          "high": 4100,
          "currency": "USD"
        },
        "analysis": {
          "scope": "intrinsic_domain_value",
          "range_source": "anchored",
          "range_width": "moderate",
          "confidence_label": "medium",
          "out_of_distribution": false,
          "out_of_distribution_reasons": [],
          "positive_factors": [
            "Strong .IO aftermarket demand"
          ],
          "negative_factors": [
            "Narrower buyer pool than .com"
          ]
        }
      },
      "score": {
        "overall": 85,
        "brandability": 90
      },
      "tld_info": {
        "type": "ccTLD",
        "trust_tier": "premium",
        "popularity_rank": 4
      },
      "recommendation_rank": 85,
      "recommendation_reason": "available for registration, premium .io TLD, excellent brand score"
    }
  ],
  "recommendation": {
    "best_available": "startup.io",
    "best_overall": "startup.com",
    "best_value": "startup.ai",
    "reasoning": "startup.io is recommended: available for registration, premium .io TLD, excellent brand score"
  },
  "decision_summary": {
    "compared_count": 3,
    "best_overall": "startup.com",
    "best_available": "startup.io",
    "runner_up": "startup.io",
    "rank_margin": 4,
    "score_margin": 2,
    "value_margin_usd": 1500,
    "availability_used": true,
    "winning_factor": "valuation",
    "tie_breaker": "higher_valuation"
  },
  "meta": {
    "compared_count": 3,
    "available_count": 2,
    "total_ms": 84
  }
}
```

#### Códigos de status HTTP

- `200` OK
- `400` Pedido inválido
- `401` Não autorizado
- `402` Pagamento necessário
- `429` Demasiados pedidos

## Recursos de referência

[OpenAPI 3.0](https://domscan.net/v1/openapi.json)
[Postman](https://domscan.net/v1/postman.json)
[MCP](https://domscan.net/pt/mcp-domain-checker)
