Contract-first REST for builders and agents. Same control plane as Fat Heron products — documented here for the developer surface.
Metered comps, research cards, drops, and acquire preview over Fat Heron’s owned domain graph. Not a Domainers LLM — your agent calls these tools.
Required scopes: research:read · Base https://api.fatheron.dev
1. Check entitlement
GET /v1/research/entitlement X-API-Key: fh_live_…
Seller-family accounts return unlimited: true. Others show included_remaining + research_credits_balance.
2. Research a domain
GET /v1/domainers/research/{domain}
X-API-Key: fh_live_…Returns structural features, live availability, observe/RDAP signals, comps stats, price_assist. Costs one Research SKU unit when metered.
3. Search comps
GET /v1/domainers/comps?q=brandable&match=contains&limit=25 X-API-Key: fh_live_…
Owned sale corpus — not a third-party dump proxy.
4. Acquire preview
GET /v1/domainers/acquire/preview/{domain}
X-API-Key: fh_live_…Availability + register/catch bridges before you act.
insufficient_scope
Mint a key with research:read (developer_full / developer_dev include it) or domainers:read.
research_quota_exceeded
Wait for monthly included reset, or ask ops to grant credits via POST /admin/v1/research/credits.
invalid domain / 400
Pass a bare hostname like example.com (no scheme or path).