Developer API
Deterministic domain appraisals, comparable sales, and recorded-sales search over plain HTTPS + JSON. The same engine and corpus that power the site - the same input always returns the same output.
API access is included with paid plans. Calls draw from a monthly API allowance that is separate from the site's appraisal credits, so a large batch through the API does not leave the account without credits on the website.
Quickstart
Create a key under Profile - API keys (shown once, store it securely), then:
curl -X POST https://audit.domains/api/v1/appraise \
-H "Authorization: Bearer ad_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "example.com"}'Keys are sent as Authorization: Bearer ad_live_... or x-api-key. Requests without a key receive 401 key_required; keys on the free plan receive 402 paid_plan_required.
A successful appraisal returns this shape (values illustrative; fields are contract-locked and the interval always accompanies the point figure):
{
"domain": "example.com",
"valueUSD": 12400,
"valueRange": { "low": 7400, "mid": 12400, "high": 20900 },
"tier": "mid-market",
"confidence": 62,
"factors": [
{ "key": "brandability", "label": "Brandability", "score": 61 },
{ "key": "length", "label": "Length", "score": 74 }
],
"methodologyVersion": "4.18",
"engineVersion": "20.0.0",
"comps": [
{ "domain": "shop.com", "priceUsd": 3500000, "year": "2014",
"venue": "Sedo", "similarity": 82,
"basis": "Shared keyword" }
],
"appraisalHash": "8c1f...e2a9",
"inputCommitment": "b44d...91c7",
"resultDigest": "f01a...77de",
"generatedAt": "2026-08-05T12:00:00.000Z",
"dataEdition": "2026-07-01"
}Endpoints
HEAD /api/v1/comps behaves as GET without a body and still spends 1 API call - do not use it as an uptime probe; poll GET /api/v1/usage or the status page instead. On /api/v1/bulk, each failed domain comes back with its own error code: appraisal_failed (the reserved call is refunded) or quota_exhausted (that domain was never charged).
Every response that reached the meter carries X-Credits-Limit, X-Credits-Remaining and X-Credits-Reset headers reporting your monthly API allowance and the date it refills - that is any 200, and the 402 you get when the allowance is spent. A request rejected before metering carries no meter to report: a malformed body, a missing or unknown key, or a 429 from the per-address limit. Read the meter without spending a call at GET /api/v1/usage.
X-RateLimit-Limit and X-RateLimit-Remaining currently repeat the same monthly allowance figures. Those names conventionally describe a short-window request limiter, which this API now has separately, so they will be redefined to report that limiter instead - not before an announced notice period of at least 30 days. Read X-Credits-* for the allowance meter.
Scopes
Each key is created with a scope. A read key can call the endpoints that spend no credits; a write key can call every endpoint. An endpoint that spends an API call refuses a read key with 403 insufficient_scope, and the scope is checked before the credit is debited, so a refused call costs nothing.
Issue read-scoped keys to anything that only searches recorded sales or polls the allowance at GET /api/v1/usage, so a leaked key from that integration cannot spend the account's monthly API allowance.
Request limits
Each key has a request limit per 60-second window, applied per key rather than per IP address, so several servers sharing one key share one budget and one server behind a shared address is not affected by its neighbours.
| Plan | Requests per minute |
|---|---|
| Plus | 60 |
| Pro | 120 |
| Max | 300 |
Over the limit, calls return 429 rate_limited with a Retry-After header in seconds and an X-RateLimit-Reset header giving the Unix second the window ends. Retry after that point rather than immediately.
Plans and credits
Each paid plan includes a monthly API allowance alongside its site appraisal credits. The two are metered separately: spending one does not spend the other.
| Plan | Price | API calls / mo | Per call | Site credits / mo | Bulk endpoint |
|---|---|---|---|---|---|
| Plus | $39/mo | 500 | $0.078 | 50 appraisals/mo | Included |
| Pro | $129/mo | 2,500 | $0.052 | 250 appraisals/mo | Included |
| Max | $399/mo | 15,000 | $0.027 | 1,500 appraisals/mo | Included |
The free plan does not include API access - keys created on a free account return 402 paid_plan_required until the account upgrades.
When the monthly API allowance is spent, calls return 402 api_quota_exhausted and site appraisal credits are unaffected. Wait for the monthly reset, or move to a larger plan on the pricing page.
Errors
Every failure returns the same JSON shape, and some codes add a field of their own on top of it - plan here. error is the only field to match on; it is stable and a given code always arrives with the same status. retryable says whether repeating the identical request can succeed, and requestId - also sent as the X-Request-Id header on every response, including successes - identifies the call in support requests.
{
"plan": "core",
"error": "api_quota_exhausted",
"message": "This account's monthly API call allowance is spent.",
"detail": "Wait for the monthly reset, or move to a larger plan at https://audit.domains/pricing. Site appraisal credits are a separate allowance and are unaffected.",
"requestId": "8f2a1c4e9b7d0000-LHR",
"docsUrl": "https://audit.domains/developers#api_quota_exhausted",
"retryable": false
}| Status | error | Retry | What to do |
|---|---|---|---|
| 400 | artifacts_required | no | Send one to fifty fresh appraisal artifacts, each complete with its identity and charge fields. |
| 400 | charge_invalid | no | Copy chargedMicrocredits from the delivery record unchanged. The charge block is evidence; it is never rounded or repaired in translation. |
| 400 | domains_required | no | Include at least one domain in the batch. |
| 400 | idempotency_key_required | no | Send an idempotencyKey of 8 to 128 characters; re-issuing with the same key resumes the same job. |
| 400 | identity_field_missing | no | Supply the field named in this response from the delivery record. The translation is lossless or it refuses; an identity field is never invented or nulled. |
| 400 | invalid_artifact | no | Fix the entry at the stated index: every identity field a non-empty string, every figure and the charge a finite number. Nothing is aggregated while one entry is malformed. |
| 400 | invalid_ask_usd | no | Send askUsd as a number of US dollars from 0 to 1,000,000,000, or omit it to vet the name without an ask. |
| 400 | invalid_certificate_input | no | Pass url (the full verifier URL) or serial (the certificate serial). |
| 400 | invalid_delivery | no | Fix the field named in this response: identity and operation fields as strings, figures and the charge as finite numbers, and the rail one of balance, card, cardAgent, x402 or sandbox. |
| 400 | invalid_domain | no | Send a registrable hostname such as example.com. |
| 400 | invalid_job_id | no | Send the jobId exactly as create returned it. |
| 400 | invalid_json | no | Send a JSON body and a Content-Type of application/json. |
| 400 | invalid_meter_request | no | Send product (a machine product id) and rail (balance, card, cardAgent or x402). |
| 400 | invalid_operation_id | no | Send an operationId of 8 to 128 characters: letters, digits, dot, underscore, colon or hyphen. |
| 400 | too_many_artifacts | no | Split the reconciliation into batches at or under the stated maximum. |
| 400 | too_many_domains | no | Split the batch; the per-call maximum is in the max field. |
| 400 | unknown_action | no | Send one of the actions named in the endpoint's detail. |
| 401 | agent_token_invalid | no | Send the agent token as Authorization: Bearer ad_agent_..., the same token the machine rails accept. |
| 401 | invalid_key | no | Check the key, or create a new one under Profile - API keys. |
| 401 | key_required | no | Send the key as Authorization: Bearer, or as the x-api-key header. |
| 402 | api_quota_exhausted | no | Move to a larger plan or wait for the monthly reset. This is separate from the site's appraisal credits, which are unaffected. |
| 402 | credits_unavailable | no | Check the key's scope (write) and remaining balance, then re-issue the create. |
| 402 | paid_plan_required | no | Upgrade the account; keys on the free plan cannot call the API. |
| 402 | quota_exhausted | no | Wait for the monthly reset, or move to a larger plan. |
| 402 | upgrade_required | no | Move to a plan that includes the feature, such as bulk. |
| 403 | insufficient_scope | no | Endpoints that spend a credit need a write-scoped key; create one. |
| 404 | figure_not_stored | no | Run a current_appraisal purchase for the name, or read its published catalog page if it has one; the cached and embed surfaces serve stored figures only and never run the engine. |
| 404 | job_not_found | no | Check the jobId, and that the calling key is the key that created the job. |
| 405 | method_not_allowed | no | Use one of the methods listed in the Allow response header. |
| 409 | idempotency_conflict | no | Re-issue the original request unchanged, or choose a new idempotency key. |
| 413 | body_too_large | no | Send a JSON body no larger than the maxBytes field. |
| 429 | rate_limited | yes | Wait the number of seconds in Retry-After, then retry. Do not retry immediately. |
| 500 | appraisal_failed | yes | Retry with backoff; quote the requestId if it persists. |
| 500 | batch_failed | yes | Retry with backoff; a job already created under your idempotency key resumes rather than double-charging. |
| 500 | comps_failed | yes | Retry with backoff; quote the requestId if it persists. |
| 500 | expiring_unavailable | yes | Retry with backoff; quote the requestId if it persists. |
| 500 | sales_unavailable | yes | Retry with backoff; quote the requestId if it persists. |
| 503 | agent_rail_meter_store_unavailable | yes | Retry with backoff. The meter refuses rather than metering without a durable event record. Nothing was charged. |
| 503 | agent_rail_meter_unconfigured | no | The machine account is not configured here, so no rail can be metered. Nothing was charged. |
| 503 | api_auth_unavailable | yes | Retry with backoff. The API refuses rather than serving unmetered. |
| 503 | batch_store_unconfigured | yes | Retry later; single and bulk appraisal calls are unaffected. |
| 503 | comparable_missing_provenance | no | The stored valuation's evidence set is stale against the corpus; a fresh appraisal rebuilds it from sales the corpus still carries. |
| 503 | engine_unavailable | yes | Retry after the number of seconds in Retry-After. A request refused for this reason spends no credit, and one refused after the charge is refunded (X-Credit-Refunded: 1). |
| 503 | figure_interval_invalid | no | The delivery failed its own sanity check and was not translated. Re-read the delivery record; the translation refuses rather than publishing an impossible interval. |
| 503 | price_drift | yes | Retry shortly; the descriptor and the catalog are reconciled from one source and the drift clears when they agree. |
| 503 | source_unavailable | no | Use source=verified for the curated corpus. |
Add audit.domains to your AI assistant
The site runs a hosted MCP server at https://audit.domains/mcp. Once it is added, your assistant can appraise a name, rank a shortlist, list recorded sales, check a certificate, and search domains listed for sale, instead of guessing a price from memory. No account or key is needed: a published name gets its catalog figure, and any other name gets a report link that runs the engine in your browser. To have the figure computed on the server instead, the assistant can buy it for $5 by card with buy_appraisal; you pay on a checkout page, never inside the chat. Programmatic and bulk volume belongs on the keyed API above. A GET on the server URL returns the discovery document with the published limits and these install links.
Domain research extension for Gemini CLI
Install three research skills with five read-only tools for domain value ranges, name comparisons and recorded sales. Published or cached results are free at audit.domains; missing figures get a browser report link. Provider charges are separate.
Install from the public extension source: gemini extensions install https://github.com/FeatureMarski/audit-domains-gemini. For the ZIP, follow the verification and installation guide above. Review the install prompt and restart the CLI. This extension cannot buy reports or spend API credits. Domain names sent to its tools are processed by audit.domains.
# Claude Code claude mcp add --transport http audit-domains 'https://audit.domains/mcp' # Gemini CLI gemini mcp add --transport http audit-domains 'https://audit.domains/mcp' # Codex CLI codex mcp add audit-domains --url 'https://audit.domains/mcp'
Claude (web, desktop, mobile)
- Customize > Connectors > + Add > Add custom connector
- Name: audit.domains. URL: https://audit.domains/mcp
- Authentication: No sign in, then Add
- In a chat: + > Connectors > turn on audit.domains
Client plan eligibility and no-sign-in support depend on Claude; verify in the current client.
ChatGPT
- Settings > Apps (or Connectors) > Advanced settings > turn on Developer mode
- Create app. Name: audit.domains. URL: https://audit.domains/mcp
- Authentication: No authentication, then Create
- In a chat: turn on audit.domains from the + menu
On ChatGPT plans that include developer mode.
Also listed on Smithery.
Prepaid agent accounts
For purchases of stored, verified appraisal artifacts, a signed-in human operator can fund an agent account by card and authorize an expiring grant with a spending limit. Agents cannot fund the account or raise that limit. This account purchases stored artifacts; fresh server computations use the paid API described above.
Read the live menu and purchase protocol before buying. Only products in settlement.sellable are offered, and availability depends on stored inventory. Follow the purchase-1 protocol with the expiring agent token and its grantId, plus an explicit maxSpendUsd within the grant limit.
Keep the operationId before sending a purchase. If the reply is uncertain, check purchase_status with the same authenticated identity, or retry the identical request with the same operationId. Do not create a new operation for an uncertain purchase. Wallet and crypto availability is published in the live menu.
Verifiable by design
Every appraisal response includes its ODVS hashes (appraisalHash, inputCommitment, resultDigest) under the Open Domain Valuation Standard: the same domain on the same engine version always yields the same commitment, and a replay that produces different numbers is provably a determinism violation. The canonicalization scheme is published in the repo's ODVS spec and covered by an independent conformance suite.