Documentation / Endpoints / Suggest names

Domain name generator API: GET /v1/suggest

Suggest names

Describe a business or project in a few words and get back name ideas, each one checked and free to register, with a line on why it fits.

Free, no key4 a minute, 60 a dayGET or POSTMCP tool: suggest_names

GEThttps://api.domainmcp.net/v1/suggest?brief=a+yoga+studio+in+Chiang+Mai&count=6

Try itReal answers, counted in your allowance

Code

curl "https://api.domainmcp.net/v1/suggest?brief=a+yoga+studio+in+Chiang+Mai&count=6"

It also takes POST with a JSON body, which suits long lists:

POST /v1/suggest

curl -X POST "https://api.domainmcp.net/v1/suggest" \
  -H "Content-Type: application/json" \
  -d '{"brief": "a yoga studio in Chiang Mai", "count": 6}'

Parameters

briefstring, required

What the business or project is, in a few words, such as a yoga studio in Chiang Mai.

countinteger, optional

How many names, from 1 to 10. 6 when left out. Fewer can come back when not enough free ones are found.

Returns

Suggestions take a few seconds, because every idea is checked before it comes back. They have their own allowance and do not use your 60 domains a minute.

domainstring

The full domain.

namestring

The name without its ending.

endingstring

The ending.

whystring

One line on why the name fits the brief.

confirmedboolean

True once the registry has answered.

bystring

Where the answer came from.

priceobject

first_year, renews, min_years, on_offer and currency.

buy_urlstring

A short link that opens a registrar with the name ready to register.

Example answer

GET /v1/suggest?brief=a+yoga+studio+in+Chiang+Mai&count=2

{
    "data": [
        {
            "domain": "lanna-still.studio",
            "name": "lanna-still",
            "ending": "studio",
            "why": "A calm identity inspired by Lanna culture and mindful movement.",
            "confirmed": true,
            "by": "registry",
            "price": {
                "first_year": 51.68,
                "renews": 68.68,
                "min_years": 1,
                "on_offer": true,
                "currency": "USD"
            },
            "buy_url": "https://buy.domainmcp.net/2uq5m2e?f=api"
        },
        {
            "domain": "mai-flow.studio",
            "name": "mai-flow",
            "ending": "studio",
            "why": "Combining local identity with the flowing nature of yoga.",
            "confirmed": true,
            "by": "registry",
            "price": {
                "first_year": 51.68,
                "renews": 68.68,
                "min_years": 1,
                "on_offer": true,
                "currency": "USD"
            },
            "buy_url": "https://buy.domainmcp.net/k2d75tt?f=api"
        }
    ],
    "meta": {
        "count": 2,
        "took_ms": 11530,
        "note": "Every name here was free when checked."
    }
}

Errors

bad_request400

No brief, or one under 3 characters.

unknown_parameter422

A parameter this endpoint does not take.

rate_limited429

Over 4 suggestion requests this minute. Wait for the seconds in Retry-After.

quota_exceeded429

Over 60 suggestion requests today. It resets at 00:00 UTC.

suggest_failed503

Names could not be drafted just now. Try again in a minute.

Every error has the same shape. See Errors for all of them.

PreviousSearch a name NextDomain details