API reference

Domain Valuation API

Estimate the market value of a domain based on multiple factors including length, keywords, TLD, and market trends. Use this reference to pick the right endpoint and see exactly what it returns.

Operations

GET /v1/value View API reference
POST /v1/value/bulk View API reference

GET /v1/value

Operation: getDomainValue Credits and authentication: 2 Authentication required
GET /v1/value Credits: 2

Query parameters

Parameter Type required
domain string required

Response fields

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

Example request

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

Example response

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

  • 200 OK
  • 401 Unauthorized
  • 402 Payment Required
  • 429 Too Many Requests

POST /v1/value/bulk

Operation: bulkDomainValue Credits and authentication: 2 Authentication required
POST /v1/value/bulk Credits: 2/item

Query parameters

Parameter Type required
dry_run string
Allowed values true
optional

Body parameters

Parameter Type required
domains string[] required

Response fields

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

Example request

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

Example response

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

  • 200 OK
  • 400 Bad Request
  • 401 Unauthorized
  • 402 Payment Required
  • 409 HTTP 409
  • 422 HTTP 422
  • 429 Too Many Requests

Reference resources