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

# ドメイン価値評価 APIリファレンス

長さ、キーワード、TLD、市場動向を含む複数の要因に基づいて、ドメインの市場価値を推定します。 このリファレンスで、最適なエンドポイントを選び、返される内容を正確に確認できます。

[製品ページを見る](https://domscan.net/ja/domain-valuation)

## 操作

GET `/v1/value` [APIリファレンスを見る](https://domscan.net/ja/docs/products/domain-valuation#getDomainValue)

POST `/v1/value/bulk` [APIリファレンスを見る](https://domscan.net/ja/docs/products/domain-valuation#bulkDomainValue)

## GET `/v1/value`

操作: `getDomainValue`
クレジットと認証: 2
認証が必要

GET /v1/value クレジット: 2

#### クエリパラメータ

| パラメータ | タイプ | 必須 |
| --- | --- | --- |
| domain | string | 必須 |

#### レスポンスフィールド

| フィールド | タイプ |
| --- | --- |
| `domain` | string |
| `label` | string |
| `tld` | string |
| `estimate` | object |
| `estimate.low` | integer |
| `estimate.mid` | integer |
| `estimate.high` | integer |
| `estimate.currency` | string |
| `factors` | object |
| `factors.length` | integer |
| `factors.lengthMultiplier` | number |
| `factors.tld` | string |
| `factors.tldTier` | string |
| `factors.tldBase` | integer |
| `factors.hasHyphens` | boolean |
| `factors.hasNumbers` | boolean |
| `factors.lettersOnly` | boolean |
| `factors.isPremiumWord` | boolean |
| `factors.isDictionaryWord` | boolean |
| `factors.isBrandable` | boolean |
| `factors.isNumericPattern` | boolean |
| `factors.isLetterPattern` | boolean |
| `factors.pronounceability` | number |
| `factors.memorability` | number |
| `factors.spellingDifficulty` | number |
| `factors.isAcronym` | boolean |
| `factors.hasCommonEnding` | boolean |
| `factors.syllableCount` | integer |
| `comparables[]` | object[] |
| `comparables[]` | object |
| `comparables[].category` | string |
| `comparables[].typical_range` | object |
| `comparables[].typical_range.low` | integer |
| `comparables[].typical_range.high` | integer |
| `comparables[].examples[]` | string[] |
| `comparables[].relevance` | number |
| `confidence` | number |
| `valuation_summary` | object |
| `valuation_summary.model_scope` | string |
| `valuation_summary.confidence` | number |
| `valuation_summary.confidence_label` | string |
| `valuation_summary.range_source` | string |
| `valuation_summary.range_width` | string |
| `valuation_summary.comparable_count` | integer |
| `valuation_summary.primary_comparable_category` | string \| null |
| `valuation_summary.primary_comparable_position` | string \| null |
| `valuation_summary.positive_driver_count` | integer |
| `valuation_summary.negative_driver_count` | integer |
| `valuation_summary.liquidity_band` | string |
| `valuation_summary.tld_tier` | string |
| `valuation_summary.renewal_price_awareness` | object |
| `valuation_summary.renewal_price_awareness.uses_tld_base` | boolean |
| `valuation_summary.renewal_price_awareness.tld_base_usd` | integer |
| `valuation_summary.renewal_price_awareness.registrar_specific_prices_included` | boolean |
| `valuation_summary.risk_flags[]` | string[] |
| `analysis` | object |
| `analysis.scope` | string |
| `analysis.excludes[]` | string[] |
| `analysis.range_source` | string |
| `analysis.range_width` | string |
| `analysis.confidence_label` | string |
| `analysis.primary_comparable_category` | string \| null |
| `analysis.primary_comparable_range` | object |
| `analysis.primary_comparable_range.low` | integer |
| `analysis.primary_comparable_range.high` | integer |
| `analysis.primary_comparable_range.position` | string |
| `analysis.primary_comparable_range.relative_position` | number |
| `analysis.out_of_distribution` | boolean |
| `analysis.out_of_distribution_reasons[]` | string[] |
| `analysis.positive_factors[]` | string[] |
| `analysis.negative_factors[]` | string[] |
| `methodology` | string |
| `meta` | object |
| `meta.served_by` | string |
| `meta.disclaimer` | string |

#### リクエスト例

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/value?domain=empresa.ind.br"
```

```javascript
const response = await fetch("https://domscan.net/v1/value?domain=empresa.ind.br", {
  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/value?domain=empresa.ind.br",
    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/value?domain=empresa.ind.br", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

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

uri = URI("https://domscan.net/v1/value?domain=empresa.ind.br")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### レスポンス例

```json
{
  "domain": "example.com",
  "label": "example",
  "tld": "com",
  "estimate": {
    "low": 10845,
    "mid": 16012,
    "high": 34266,
    "currency": "USD"
  },
  "factors": {
    "length": 7,
    "lengthMultiplier": 2,
    "tld": "com",
    "tldTier": "premium",
    "tldBase": 1500,
    "hasHyphens": false,
    "hasNumbers": false,
    "lettersOnly": true,
    "isPremiumWord": false,
    "isDictionaryWord": false,
    "isBrandable": true,
    "isNumericPattern": false,
    "isLetterPattern": false,
    "pronounceability": 0.87,
    "memorability": 0.87,
    "spellingDifficulty": 0.8,
    "isAcronym": false,
    "hasCommonEnding": false,
    "syllableCount": 3
  },
  "comparables": [
    {
      "category": ".com brandable 5-7 chars",
      "typical_range": {
        "low": 2000,
        "high": 80000
      },
      "examples": [
        "Lyft ($225K), Uber ($100K est.), Klarna"
      ],
      "relevance": 0.76
    }
  ],
  "confidence": 0.66,
  "analysis": {
    "scope": "intrinsic_domain_value",
    "excludes": [
      "website_traffic",
      "revenue",
      "brand_equity",
      "buyer-specific strategic premium"
    ],
    "range_source": "blended",
    "range_width": "moderate",
    "confidence_label": "medium",
    "primary_comparable_category": ".com brandable 5-7 chars",
    "primary_comparable_range": {
      "low": 2000,
      "high": 80000,
      "position": "mid",
      "relative_position": 0.56
    },
    "out_of_distribution": false,
    "out_of_distribution_reasons": [],
    "positive_factors": [
      "Premium .com market liquidity",
      "Pronounceable and brandable label",
      "Anchored by .com brandable 5-7 chars comparables"
    ],
    "negative_factors": []
  },
  "methodology": "Algorithmic intrinsic-domain estimate anchored to public domain sales data. It excludes website traffic, revenue, and business/company value, and uses length, TLD tier, character composition, brandability, semantic segmentation, and market comparables from NameBio/DNJournal-style buckets.",
  "valuation_summary": {
    "model_scope": "intrinsic_domain_value",
    "confidence": 0.66,
    "confidence_label": "medium",
    "range_source": "blended",
    "range_width": "moderate",
    "comparable_count": 1,
    "primary_comparable_category": ".com brandable 5-7 chars",
    "primary_comparable_position": "mid",
    "positive_driver_count": 3,
    "negative_driver_count": 0,
    "liquidity_band": "high",
    "tld_tier": "premium",
    "renewal_price_awareness": {
      "uses_tld_base": true,
      "tld_base_usd": 1500,
      "registrar_specific_prices_included": false
    },
    "risk_flags": []
  },
  "meta": {
    "served_by": "pop=MAD country=ES",
    "disclaimer": "This is an algorithmic estimate based on domain characteristics. Actual market value may vary significantly based on buyer demand, comparable sales, and market conditions."
  }
}
```

#### HTTP ステータスコード

- `200` 成功
- `401` 未認証
- `402` 支払いが必要
- `429` リクエスト過多

## POST `/v1/value/bulk`

操作: `bulkDomainValue`
クレジットと認証: 2
認証が必要

POST /v1/value/bulk クレジット: 2/item

#### クエリパラメータ

| パラメータ | タイプ | 必須 |
| --- | --- | --- |
| dry_run | string 許可された値 `true` | オプション |

#### ボディパラメータ

| パラメータ | タイプ | 必須 |
| --- | --- | --- |
| domains | string[] | 必須 |

#### レスポンスフィールド

| フィールド | タイプ |
| --- | --- |
| `results[]` | object[] |
| `results[]` | object |
| `results[].domain` | string |
| `results[].label` | string |
| `results[].tld` | string |
| `results[].estimate` | object |
| `results[].estimate.low` | integer |
| `results[].estimate.mid` | integer |
| `results[].estimate.high` | integer |
| `results[].estimate.currency` | string |
| `results[].factors` | object |
| `results[].factors.length` | integer |
| `results[].factors.lengthMultiplier` | number |
| `results[].factors.tld` | string |
| `results[].factors.tldTier` | string |
| `results[].factors.tldBase` | integer |
| `results[].factors.hasHyphens` | boolean |
| `results[].factors.hasNumbers` | boolean |
| `results[].factors.lettersOnly` | boolean |
| `results[].factors.isPremiumWord` | boolean |
| `results[].factors.isDictionaryWord` | boolean |
| `results[].factors.isBrandable` | boolean |
| `results[].factors.isNumericPattern` | boolean |
| `results[].factors.isLetterPattern` | boolean |
| `results[].factors.pronounceability` | number |
| `results[].factors.memorability` | number |
| `results[].factors.spellingDifficulty` | number |
| `results[].factors.isAcronym` | boolean |
| `results[].factors.hasCommonEnding` | boolean |
| `results[].factors.syllableCount` | integer |
| `results[].comparables[]` | object[] |
| `results[].comparables[]` | object |
| `results[].comparables[].category` | string |
| `results[].comparables[].typical_range` | object |
| `results[].comparables[].typical_range.low` | integer |
| `results[].comparables[].typical_range.high` | integer |
| `results[].comparables[].examples[]` | string[] |
| `results[].comparables[].relevance` | number |
| `results[].confidence` | number |
| `results[].valuation_summary` | object |
| `results[].valuation_summary.model_scope` | string |
| `results[].valuation_summary.confidence` | number |
| `results[].valuation_summary.confidence_label` | string |
| `results[].valuation_summary.range_source` | string |
| `results[].valuation_summary.range_width` | string |
| `results[].valuation_summary.comparable_count` | integer |
| `results[].valuation_summary.primary_comparable_category` | string \| null |
| `results[].valuation_summary.primary_comparable_position` | string \| null |
| `results[].valuation_summary.positive_driver_count` | integer |
| `results[].valuation_summary.negative_driver_count` | integer |
| `results[].valuation_summary.liquidity_band` | string |
| `results[].valuation_summary.tld_tier` | string |
| `results[].valuation_summary.renewal_price_awareness` | object |
| `results[].valuation_summary.renewal_price_awareness.uses_tld_base` | boolean |
| `results[].valuation_summary.renewal_price_awareness.tld_base_usd` | integer |
| `results[].valuation_summary.renewal_price_awareness.registrar_specific_prices_included` | boolean |
| `results[].valuation_summary.risk_flags[]` | string[] |
| `results[].analysis` | object |
| `results[].analysis.scope` | string |
| `results[].analysis.excludes[]` | string[] |
| `results[].analysis.range_source` | string |
| `results[].analysis.range_width` | string |
| `results[].analysis.confidence_label` | string |
| `results[].analysis.primary_comparable_category` | string \| null |
| `results[].analysis.primary_comparable_range` | object |
| `results[].analysis.primary_comparable_range.low` | integer |
| `results[].analysis.primary_comparable_range.high` | integer |
| `results[].analysis.primary_comparable_range.position` | string |
| `results[].analysis.primary_comparable_range.relative_position` | number |
| `results[].analysis.out_of_distribution` | boolean |
| `results[].analysis.out_of_distribution_reasons[]` | string[] |
| `results[].analysis.positive_factors[]` | string[] |
| `results[].analysis.negative_factors[]` | string[] |
| `results[].methodology` | string |
| `results[].meta` | object |
| `results[].meta.served_by` | string |
| `results[].meta.disclaimer` | string |
| `errors[]` | object[] |
| `errors[]` | object |
| `errors[].input` | string |
| `errors[].error` | object |
| `meta` | object |
| `meta.served_by` | string |
| `meta.total` | integer |
| `meta.requested` | integer |
| `meta.invalid` | integer |
| `meta.duplicates_removed` | integer |
| `meta.disclaimer` | string |

#### リクエスト例

```bash
curl -X POST "https://domscan.net/v1/value/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domains": [
    "example.com",
    "startup.io",
    "brand.ai"
  ]
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/value/bulk", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "domains": [
      "example.com",
      "startup.io",
      "brand.ai"
    ]
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.post(
    "https://domscan.net/v1/value/bulk",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "domains": [
            "example.com",
            "startup.io",
            "brand.ai",
        ],
    },
)
print(response.json())
```

```go
package main

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

func main() {
	body := strings.NewReader(`{
	  "domains": [
	    "example.com",
	    "startup.io",
	    "brand.ai"
	  ]
	}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/value/bulk", 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))
}
```

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

uri = URI("https://domscan.net/v1/value/bulk")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "domains" => [
    "example.com",
    "startup.io",
    "brand.ai"
  ]
})

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

#### レスポンス例

```json
{
  "results": [
    {
      "domain": "example.com",
      "label": "example",
      "tld": "com",
      "estimate": {
        "low": 1,
        "mid": 1,
        "high": 1,
        "currency": "USD"
      },
      "factors": {
        "length": 1,
        "lengthMultiplier": 0.5,
        "tld": "com",
        "tldTier": "premium",
        "tldBase": 1,
        "hasHyphens": false,
        "hasNumbers": false,
        "lettersOnly": false,
        "isPremiumWord": false,
        "isDictionaryWord": false,
        "isBrandable": false,
        "isNumericPattern": false,
        "isLetterPattern": false,
        "pronounceability": 0.5,
        "memorability": 0.5,
        "spellingDifficulty": 0.5,
        "isAcronym": false,
        "hasCommonEnding": false,
        "syllableCount": 1
      },
      "comparables": [
        {
          "category": "example",
          "typical_range": {
            "low": 1,
            "high": 1
          },
          "examples": [
            "example"
          ],
          "relevance": 0.5
        }
      ],
      "confidence": 0.85,
      "valuation_summary": {
        "model_scope": "intrinsic_domain_value",
        "confidence": 0.85,
        "confidence_label": "low",
        "range_source": "heuristic",
        "range_width": "narrow",
        "comparable_count": 1,
        "primary_comparable_category": "example",
        "primary_comparable_position": "lower",
        "positive_driver_count": 1,
        "negative_driver_count": 1,
        "liquidity_band": "low",
        "tld_tier": "premium",
        "renewal_price_awareness": {
          "uses_tld_base": false,
          "tld_base_usd": 1,
          "registrar_specific_prices_included": false
        },
        "risk_flags": [
          "example"
        ]
      },
      "analysis": {
        "scope": "intrinsic_domain_value",
        "excludes": [
          "example"
        ],
        "range_source": "heuristic",
        "range_width": "narrow",
        "confidence_label": "low",
        "primary_comparable_category": "example",
        "primary_comparable_range": {
          "low": 1,
          "high": 1,
          "position": "lower",
          "relative_position": 0.5
        },
        "out_of_distribution": false,
        "out_of_distribution_reasons": [
          "example"
        ],
        "positive_factors": [
          "example"
        ],
        "negative_factors": [
          "example"
        ]
      },
      "methodology": "example",
      "meta": {
        "served_by": "example",
        "disclaimer": "example"
      }
    }
  ],
  "errors": [
    {
      "input": "example",
      "error": {}
    }
  ],
  "meta": {
    "served_by": "example",
    "total": 1,
    "requested": 1,
    "invalid": 1,
    "duplicates_removed": 1,
    "disclaimer": "example"
  }
}
```

#### HTTP ステータスコード

- `200` 成功
- `400` 不正なリクエスト
- `401` 未認証
- `402` 支払いが必要
- `409` HTTP 409
- `422` HTTP 422
- `429` リクエスト過多

## リファレンスリソース

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