> 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/docs/products/domain-compare

# Domain Compare API

Compare multiple domains side by side on various metrics including valuation, health, and SEO factors. Use this reference to pick the right endpoint and see exactly what it returns.

[View product page](https://domscan.net/domain-compare)

## Operations

GET `/v1/compare` [View API reference](https://domscan.net/docs/products/domain-compare#compareDomains)

## GET `/v1/compare`

Operation: `compareDomains`
Credits and authentication: 3
Authentication required

GET /v1/compare Credits: 3

#### Query parameters

| Parameter | Type | required |
| --- | --- | --- |
| domains | string | required |
| dry_run | string Allowed values `true` | optional |

#### Response fields

| Field | Type |
| --- | --- |
| `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 |

#### Example request

```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))
```

#### Example response

```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
  }
}
```

#### HTTP status codes

- `200` OK
- `400` Bad Request
- `401` Unauthorized
- `402` Payment Required
- `429` Too Many Requests

## Reference resources

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