How to value a domain

Overview

This guide covers retrieving a domain's GoValue valuation (GoDaddy's machine-learned estimate of what the domain is worth) programmatically with the Domain valuation API. A single call to GET /v1/domains/govalues returns the estimated value, a suggested Afternic list price, a wholesale value, a price range, and predicted yearly sales probabilities.

Access is subscription-based. Go to About Domain valuation for what each field means and how the valuation model behaves.

Prerequisites

The following prerequisites are required before you can use the Domain Valuation API:

• an active GoValue subscription on your GoDaddy account

  Subscription required

  Subscribe on the GoDaddy domain value appraisal page. Plans differ by daily request limit.

• a PAT with the domains.domain:read scope

Get a valuation

GET /v1/domains/govalues?domainName={domain} returns the GoValue valuation for a single domain.

• Request the valuation:

curl -s "https://api.godaddy.com/v1/domains/govalues?domainName=testdomain.com" \
  -H "Authorization: Bearer $GODADDY_PAT"

The following example shows a successful response with the valuation and your current usage allowance:

{
  "status": "OK",
  "domainName": "testdomain.com",
  "goValue": { "currencyCode": "USD", "value": 1234 },
  "goValueWholesale": { "currencyCode": "USD", "value": 900 },
  "minPrice": { "currencyCode": "USD", "value": 1000 },
  "maxPrice": { "currencyCode": "USD", "value": 1600 },
  "listPrice": { "currencyCode": "USD", "value": 1500 },
  "salesProbability": 0.000581,
  "salesProbability500": 0.000581,
  "salesProbabilityWholesale": 0.000581,
  "maxDailyUsage": 1000,
  "dailyUsage": 500
}

Go to About Domain valuation for a description of each response field and how to interpret the daily-request-limit fields.

Common errors

The following table lists common errors and recommended actions. Go to Errors for the full error envelope.

Last updated on