DEVELOPER REFERENCE

API Reference

API access is included with the Committed plan. Keys are created in your account settings.

Authentication

All /api/v1/* requests require an X-API-Key header. Keys are tied to your Committed plan subscription and are created in account settings. A missing or invalid key returns HTTP 401.

X-API-Key: YOUR_KEY

Rate Limit

500 calls per day, shared across all /api/v1/* endpoints. The counter resets at midnight UTC. When the limit is reached, requests return HTTP 429 until the next reset.

429 Response

{
  "error": "rate_limit_exceeded",
  "limit": 500
}

GET /api/v1/check

Checks availability status for a domain name. Returns the current observed status and the timestamp of the most recent check.

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://likelytaken.com/api/v1/check?name=nova-ai"

Query Parameters

name*
string
The name or domain slug to check. Example: nova-ai

Response

{
  "name": "nova-ai",
  "status": "single",
  "status_label": "Single (Available)",
  "checked_at": "2026-03-12T00:00:00Z"
}

Status Values

single
Domain is available for registration.
taken_active
Domain is registered with an active site.
taken_inactive
Domain is registered; site appears inactive.
for_sale
Domain is parked for sale.
parked
Domain is parked with no listed sale price.

GET /api/v1/scarcity

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://likelytaken.com/api/v1/scarcity?name=nova-ai"

Returns scarcity intelligence for a name: demand score, entity richness tier, and expiration proximity when available. Demand scores are probabilistic signals derived from search frequency, entity richness, and domain registration history — not guarantees of future availability or timing.

Query Parameters

name*
string
The name or domain slug to check. Example: nova-ai

Response

{
  "name": "nova-ai",
  "demand_score": 84,
  "richness_tier": 2,
  "expiration_proximity_days": null
}

Response Fields

demand_score
integer
0–100 signal of how frequently this name appears in searches and how many entities compete for it.
richness_tier
integer
1–3. Higher tiers indicate the name has more associated entities (trademarks, social handles, products).
expiration_proximity_days
integer | null
Days until the registered domain likely expires, based on RDAP data. Null if the domain is available or expiration data is unavailable.

API access is included with the Committed plan. $12/month. Cancel anytime. No questions.

likelytaken.com — naming intelligence