api

The same JSON as the site

REST, JSON, bearer keys. Create a key in your account, then call any endpoint below. Machine-readable spec at /api/v1/openapi.json (OpenAPI 3.1).

quotas by plan
PlanAPI calls / monthCredits / monthBulk limitEndpoints
Trial30050100 / batchappraise, usage, bulk, drops
Starter1,000300500 / batchappraise, usage, bulk, drops

Credits pay for engine work, one per appraisal and one per domain in bulk. The API quota counts requests. Both reset monthly.

quickstart
Appraise a domainbash
curl -X POST https://resaleodds.com/api/v1/appraise \
  -H "Authorization: Bearer dsk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "creditseason.com"}'
Submit a bulk job (Pro and up)bash
curl -X POST https://resaleodds.com/api/v1/bulk \
  -H "Authorization: Bearer dsk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["a.com", "b.com", "c.com"]}'
Check your usage (free)bash
curl https://resaleodds.com/api/v1/usage \
  -H "Authorization: Bearer dsk_YOUR_KEY"
mcp server
https://resaleodds.com/api/mcpStreamable HTTP
claude mcp add --transport http domainvalue https://resaleodds.com/api/mcp \
  --header "Authorization: Bearer dsk_YOUR_KEY"

Tools appraise_domain, list_drops and get_usage, same quotas as the REST endpoints. Details and other clients on the page for agents.

endpoints
  • post/api/v1/appraise

    Appraise a single domain

    Costs 1 API call + 1 credit. Cached results (24h, same calibration) are free.

  • post/api/v1/bulk

    Submit a bulk appraisal job

    Pro plan and above. 1 API call + 1 credit per domain. Results ranked by opportunity (value × probability of sale).

  • get/api/v1/bulk/{id}

    Poll a bulk job

  • get/api/v1/drops

    Daily curated expired domains

    Pro plan and above. Safe-zone filtered, opportunity-ranked. Source is a deterministic mock until CZDS zone-file access is granted (clearly labeled).

  • get/api/v1/demand/{domain}

    Solvent demand: buyer candidates and upgrade-domain targets

    Business plan. Who could buy this name (with budget bands) and which degraded variants (hyphenated, other TLDs, prefixed) host active sites — the documented upgrade-buyer profile. Candidates are flagged `simulated: true` until live company search is enabled.

  • get/api/v1/usage

    Current API usage and quota

    Free of charge (cost 0).

Errors and rate headers

Errors are always {"error": {"code", "message"}} with meaningful HTTP statuses: 401 key, 402 credits, 403 plan, 422 input, 429 quota. Every authorized response carries X-RateLimit-Limit / Used / Remaining / Month.