API

Programmatic domain valuations

One JSON endpoint, deterministic results. Send a domain, get back a full valuation — value, range, confidence, comparables and the factor breakdown — the same engine that powers this site.

Overview

The API is a thin HTTP layer over the V3 valuation engine. Requests are GET calls, responses are JSON. Results are cached and reproducible — the same domain returns the same valuation until its evidence base changes — then adjusted by a small market-conditions factor (capped at ±2%) that refreshes weekly, so values track the live aftermarket instead of sitting frozen. Base URL:

https://domaintier.com

Authentication

Pass your key in the x-api-key header (or, for quick tests, an ?key= query parameter). Requests are rate-limited per key.

x-api-key: dt_live_xxxxxxxxxxxxxxxxxxxx

Endpoints

Access tiers

The same engine powers every plan. Only Enterprise can call it programmatically with a key; everyone else uses it through the website.

TierAccessWhat you get

Anonymous Website 3 quick valuations per IP per day. mode=quick only; mode=full returns 401.

Free Website 100 credits a month. Quick costs 1, a full report 3.

Pro Website More monthly credits, plus bulk valuations.

Enterprise API key A Bearer key for the quick, full and bulk endpoints, at higher limits. See plans.

GET/api/valuate/json

Full valuation: value, wholesale floor, strategic upside, confidence, comparables, factor scores and supporting commentary. Parameter: domain.

GET/api/valuate/quick

Alias of /api/valuate/json?mode=quick. Returns the three price tiers (wholesale, retail, retail upside) only. Costs 1 credit for signed-in callers; anonymous callers get 3 valuations per IP per day before hitting 402 anon_limit_exceeded.

GET/api/sales

Recorded comparable sales for a name or fragment. Parameter: domain.

GET/api/similar

Semantic nearest-neighbour domains for a query name. Parameters: domain, limit.

Response envelope

Signed-in responses include credits_remaining: {monthly: N, topup: M}. Out-of-credits returns HTTP 402 with {error, available, required, resets_at}.

Example request

curl https://domaintier.com/api/valuate/json?domain=example.com \
  -H "x-api-key: dt_live_xxxxxxxxxxxx"

Example response

{
  "ok": true,
  "valuation": {
    "domain": "example.com",
    "value_usd": 981625,
    "wholesale": { "value_usd": 392650 },
    "retail_upside": { "value_usd": 2158000 },
    "confidence": 71,
    "length": 7,
    "ext": "com",
    "comparables": [ /* ranked comparable sales */ ],
    "factors": { /* 9 factor scores */ }
  }
}

See Methodology for what each field means and how the figures are derived.

Rate limits & caching

Each key has a per-minute request budget; exceeding it returns 429 Too Many Requests. Valuations are cached server-side, so repeat lookups of the same domain are fast and don't count heavily against your budget. Unauthenticated or invalid-key requests return 401 Unauthorized.

Get an API key

The programmatic API is part of the Enterprise plan. Upgrade and your key is ready in your account, no waiting.

See plans →