Select Page

AI Domain Name Generator API

Description

Need some inspiration for your next project? or perhaps you need to find a viable domain name for an existing project? This API endpoint will provide you with a wide range of suggestions for domain names that you could potentially buy and use.

Under the hood we use a variety of different AI models in order to enrich the output and increase its variety.

Endpoint Cost

2 token/credit per request

Endpoint

> POST https://api.jsonrepo.com/v1/branding/ai_domain_generator

Headers

Field Description
X-API-Key Required Your API Key

Parameters

Field Type Description
description String Required the concept description for which the recommendations will be generated
Format: English alphanumeric string
Length: 20 <= length <= 120
tld String Optional preferred tld.
Format: alphabetical string
limit Integer Optional The number of maximum recommendations to be generated by our AI
Default: 10.
Range: 1 <= limit <= 15

Response

A successful request will result in a populated payload field with the expected output. Along with the recommendations we will generate a readability and memorability score based on linguistic markers for each of the recommended domain names.

Domain Availability:

At the moment, our system does not check the domain availability. This is a feature we'll be adding soon. This endpoint only generates recommendations atm and you'll have to lookup the availability of the recommendations you like on your own.

Response Time:

As you are probably well aware, AI output is bound by the efficiency of the model and the prompt enabling it. The bigger your limit is, the longer the request will take to process. Please be patient as processing the information could sometimes take between 1 and 5 seconds.

Output Duplication:

AIs are notorious for their heuristic outputs, after all they are heuristic output machines and do not always satisfy the prompts given deterministically. For that reason, it is important to keep in mind that subsequent requests with the same input may in some cases generate similar outputs.

Example

Request Example
// Generate domain names for the concept: `an ecommerce store that sells shoes`
// Tld: com
// Limit: 5

curl -X POST https://api.jsonrepo.com/v1/branding/ai_domain_generator \
-H "X-API-Key: {YOUR_API_KEY_HERE}" \
--data-urlencode "description=an ecommerce store that sells shoes" \
--data-urlencode "tld=com"
--data-urlencode "limit=5"
// Server Response

{
    "http_code": 200,
    "http_message": "Ok",
    "timestamp": 1729809059,
    "message": "Successful execution.",
    "payload": {
        "domains": [
            {
                "domain": "kickszone.com",
                "length": 13,
                "readability": 92,
                "memorability": 88
            },
            {
                "domain": "shoebuzz.com",
                "length": 12,
                "readability": 94,
                "memorability": 90
            },
            {
                "domain": "shoestopia.com",
                "length": 14,
                "readability": 89,
                "memorability": 82
            },
            {
                "domain": "shoecrush.com",
                "length": 13,
                "readability": 92,
                "memorability": 88
            },
            {
                "domain": "walkthiswaystore.com",
                "length": 20,
                "readability": 78,
                "memorability": 66
            }
        ]
    }
}

Errors

A failed request will result in an error output as detailed in Error Rules. If the endpoint validation fails due to missing, badly formatted or invalid parameters, the endpoint will return HTTP code 400 along with a message detailing the error.

Error Response
// Request without `description` field

{
    "http_code": 400,
    "http_message": "Bad Request",
    "timestamp": 1729808838,
    "message": "'description' parameter must be provided as an alphanumeric string of min length 20 and max length 100.",
    "payload": []
}