---
title: "AI-powered domain suggestions with availability"
method: GET
path: "/api/domains/suggest"
tags: ["Domain Search"]
---

# AI-powered domain suggestions with availability

`GET /api/domains/suggest`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/domains/suggest`
- Auth: none required

Given a project description, generates full domain names with creative TLDs (e.g. codebuddy.dev, wavify.fm), checks availability, and returns only available domains with pricing. Uses an agentic loop that retries until enough available domains are found. Supports SSE streaming via `Accept: text/event-stream` - closing the connection cancels in-flight LLM generation and RDAP lookups server-side. **Public endpoint** - no authentication required.

## Query parameters

- `prompt` string, required
- `count` integer
- `exclude` string
- `tlds` string
- `style` 'single' | 'creative' | 'short' | 'brandable' | 'keyword'
- `lang` 'japanese' | 'spanish' | 'french' | 'italian' | 'latin' | 'nordic' | 'arabic' | 'sanskrit'

## Response `200`

Available domain suggestions with pricing. With `Accept: text/event-stream`, streams SSE events: `candidates` (names generated), `checking` (batch being checked), `result` (each checked domain, available or not), `iteration` (loop round), `done` (summary), `error`. A later `result` for the same domain replaces an earlier one: a name the registry holds back comes back `available: false`, with `registry_status` (`premium` or `reserved`) and, for a premium name, `registry_price` when known.

- object
  - `suggestions` object[], required: Available domain names with pricing
    - `domain` string, required: Full domain name with TLD
    - `price` number, required: Registration price in USD
    - `currency` string, required: Currency code
    - `renewal_price` number: What each year after the first costs, in USD. Absent when unknown.
  - `checked` integer, required: Total domains checked
  - `iterations` integer, required: Number of LLM rounds

## Other responses

- `400`: Invalid request parameters
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)