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 are metered against your plan's monthly appraisal credits - one quota across the site and the API, no separate API billing.
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.
Endpoints
| Endpoint | Metering | What it returns |
|---|---|---|
| POST /api/v1/appraise | 1 credit | Deterministic appraisal of one domain: value, range, tier, confidence, named factor scores, top-5 comparables, and the ODVS hashes that make the result independently verifiable. |
| GET /api/v1/comps?domain=&limit= | 1 credit | The top comparable sales for a domain (runs the same matching engine as an appraisal). |
| POST /api/v1/bulk | 1 credit per domain | Appraise up to 20 domains in one call. Requires a plan with bulk enabled; credits are debited per processed domain. |
| GET /api/v1/sales | no credit | Recorded domain sales with filters and pagination (q, tld, price and year ranges, venue, sort, page, pageSize up to 100). source=verified (curated corpus, default) or source=ledger (research ledger). |
Every response carries X-RateLimit-Limit and X-RateLimit-Remaining headers reporting your monthly credit meter. When credits are spent, calls return 402 quota_exhausted until the monthly reset.
Plans and credits
API calls draw from the same monthly appraisal credits as the site.
| Plan | Price | Monthly credits | Bulk endpoint |
|---|---|---|---|
| Plus | $39/mo | 50 appraisals/mo | Included |
| Pro | $129/mo | 250 appraisals/mo | Included |
| Max | $399/mo | 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.
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.