API 레퍼런스

도메인 평가 API 레퍼런스

길이, 키워드, TLD 및 시장 동향을 포함한 여러 요소를 기반으로 도메인의 시장 가치를 추정합니다. 이 레퍼런스에서 알맞은 엔드포인트를 고르고 반환되는 결과를 정확히 확인하세요.

작업

GET /v1/value API 레퍼런스 보기
POST /v1/value/bulk API 레퍼런스 보기

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

예제 요청

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/value?domain=empresa.ind.br"
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);
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())
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"))

	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/value?domain=empresa.ind.br")
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))

예제 응답

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

예제 요청

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

예제 응답

{
  "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 요청 과다

레퍼런스 리소스