PaidDomain Check API

Appraise name

POST/names/{name}/appraiseMember key

Runs the appraisal of one stored name when its estimate is missing, and returns the value resource.

A fresh estimate answers 200 with Appraisal=0 and no run. A run this call started answers 200 with Appraisal=1; a run another call holds answers 202 with Retry-After: 30 and Appraisal=0, and a run another call finished meanwhile 200 with Appraisal=0. The name must be stored: run POST /names/{name}/check first. 5,000 runs a UTC day for the whole API.

AccessA member key (Founder or Investor) or a paid RapidAPI subscription to this API.

BillingOne call, plus one appraisal when the appraisal runs.

PlanInvestor plan. A Founder key answers 403 plan_required.

FormatsJSON

Keep a key on a server: a page a visitor loads shows it to everyone.

Connect on RapidAPIAlso inDomain Appraisal API

Request

namestringRequiredPath

A full domain name on an ending the catalog holds, lowercased, IDN as punycode. A bare word, a subdomain, an e-mail address or an unknown ending answers 400 validation_failed with reason and suggestion.

fieldsstringOptionalQuery

Comma-separated top-level keys to keep; an unknown key answers 400 unsupported_field.

curl -X POST "https://api.unique.domains/v1/names/get.plumbing/appraise" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"

const response = await fetch("https://api.unique.domains/v1/names/get.plumbing/appraise", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_MEMBER_KEY",
    },
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.unique.domains/v1/names/get.plumbing/appraise",
    headers={
        "Authorization": "Bearer YOUR_MEMBER_KEY",
    },
)

print(response.json())

req, err := http.NewRequest("POST", "https://api.unique.domains/v1/names/get.plumbing/appraise", nil)
if err != nil {
    panic(err)
}
req.Header.Set("Authorization", "Bearer YOUR_MEMBER_KEY")

res, err := http.DefaultClient.Do(req)

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.unique.domains/v1/names/get.plumbing/appraise",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_MEMBER_KEY",
    ],
]);
$response = curl_exec($ch);

uri = URI("https://api.unique.domains/v1/names/get.plumbing/appraise")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_MEMBER_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

Response

currentobject | null

historyobject[]

Errors

validation_failed400

A value is not valid

keyed_only403

A paid subscription is required

not_found404

Not found

budget_spent429

Today's budget is spent

rate_limited429

Too many requests

internal500

Unexpected error

check_unavailable503

The live check is unavailable

200 · application/jsonExample

{
  "data": {
    "current": {
      "value": 4200,
      "asOf": "2026-10-30T11:02:00.000Z"
    },
    "history": [
      {
        "value": 4200,
        "date": "2026-10-30T11:02:00.000Z"
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/get.plumbing/appraise",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}

Appraise name

Request

Response

Errors

Related endpoints