Getting Started

The Appraise.net API lets you integrate domain appraisals directly into your own applications, scripts, and workflows. This guide covers everything you need to get started.

Who Can Use the API

API access is available on Business, Enterprise, and Partner subscription plans. You can generate API keys from your subscription dashboard once you are on an eligible plan.

Authentication

Every API request requires two credentials, passed as HTTP headers:

• X-API-Key — Your API key (starts with ak_live_). You can reveal it on your Profile page after confirming your password.
• X-API-Secret — A 64-character hex string shown only once when you create it. You can regenerate it on your Profile page (requires password confirmation), but doing so immediately invalidates the previous secret.

Security warning: These credentials grant full access to your credits. Never share them, commit them to source control, or expose them in client-side code.

Your First API Call

The simplest call is a single domain appraisal:

curl -X POST https://appraise.net/api/v1/appraisal -H "Content-Type: application/json" -H "X-API-Key: ak_live_your_key_here" -H "X-API-Secret: your_secret_here" -d "{\"domain\": \"example.com\"}"

The API returns a JSON response. For the full response schema and all available endpoints, refer to the interactive API documentation at /api/docs.

Batch Appraisals

To appraise many domains at once, use the batch endpoint:

curl -X POST https://appraise.net/api/v1/appraisal/batch -H "Content-Type: application/json" -H "X-API-Key: ak_live_your_key_here" -H "X-API-Secret: your_secret_here" -d "{\"domains\": [\"domain1.com\", \"domain2.com\", \"domain3.com\"]}"

Batch job progress and results can be tracked on the API Activity page.

Duplicate Protection

The API automatically prevents duplicate submissions. If you submit a domain that is already being processed in a pending job, the API will return the existing job details instead of creating a new one. For batch requests, any domains already in-flight are skipped and reported in the skipped_domains field of the response. This protects you from being charged twice for the same appraisal.

Credit Pricing

API calls consume credits from your account balance at these rates:

• New appraisal (real-time) — 3 credits
• New appraisal (batch) — 2 credits
• Cached appraisal (previously appraised by another user) — 1 credit
• Your own appraisal (you already appraised this domain) — 0 credits

Rate Limits

You can make API calls from any number of clients with no device or IP restrictions. Rate limits vary by plan:

• Business — 30 requests/minute, 5,000 requests/day
• Enterprise — 60 requests/minute, 10,000 requests/day
• Partner — 100 requests/minute, 30,000 requests/day

Viewing Results in the Web UI

All appraisals created via the API are automatically available in the web interface. You can find them in My Appraisals, or view any individual appraisal at /appraisal?domain=example.com.

API Activity Page

The API Activity page (visible in the navigation menu once you have an API key) provides a complete overview of your API usage:

• Summary stats — Total requests, domains processed, credits used, and success rate.
• Batch Jobs table — Shows all batch jobs with status, domain count, and credits charged. Expand any job to see the individual domains and click through to their appraisals.
• Recent API Requests table — Lists the last 50 API requests with endpoint, method, status code, response time, and credits charged.