Name Kitchen Logo

Name Kitchen API

Integrate our powerful, free, phonetics-based name generation engine directly into your applications.

How to Use the API

You can generate names by making a simple GET request to the API's base URL. All customization is handled through URL query parameters.

Base URL

https://api.namekitchen.net/generate/

Query Parameters

All parameters are optional. The API will use sensible defaults if a parameter is not provided.

Parameter Description Default Example Values
count The number of unique names to generate. (Max: 50) 8 10, 25
min The minimum length of the generated names. 3 4, 5
max The maximum length of the generated names. 6 8, 12
tone Influences the "feel" of the name by biasing certain sounds. neutral brand, soft, hard, fantasy
startsWith Constrains the first letter. `prefix` overrides this. any vowel, consonant, a, z
prefix A required starting string for all names. '' Pro, Zen
suffix A required ending string for all names. '' ly, ify
exclude Comma-separated list of letters or letter clusters to forbid. '' x,q,zz
excludePhonemes Comma-separated list of specific phonemes (e.g., `th`, `ae`) to forbid. '' br,ae,st
probVowelCluster Probability (0.0 to 1.0) of using a vowel cluster (`ae`, `io`). 0.2 0.5, 0.75
probConsonantCluster Probability (0.0 to 1.0) of using a consonant cluster (`br`, `st`). 0.25 0.1, 0.6
probStartWithVowel Probability (0.0 to 1.0) that a name starts with a vowel. 0.3 0.5, 0.9
probAddFinalCluster Probability (0.0 to 1.0) of adding a final cluster (`nd`, `rk`). 0.4 0.1, 0.8

Example Requests

Simple Request

Generate 5 names using default settings.

curl "https://api.namekitchen.net/generate/?count=5"

Advanced Request

Generate 10 "brandable" names, 5-8 characters long, starting with "V", and excluding the letter 'x'.

curl "https://api.namekitchen.net/generate/?count=10&tone=brand&min=5&max=8&startsWith=v&exclude=x"

Prefix and High Probability Request

Generate names that start with "Glo" and have a high chance of using vowel clusters.

curl "https://api.namekitchen.net/generate/?prefix=Glo&probVowelCluster=0.8"

Excluding Multiple Items

To exclude multiple letter clusters or specific phonemes, provide them as a comma-separated list.

curl "https://api.namekitchen.net/generate/?exclude=x,zz,qu&excludePhonemes=th,sh,br"

Response Format

The API returns a JSON object containing the generated names and a summary of the parameters used for the request.

Example Response

{
  "success": true,
  "names": [
    "Voratech",
    "Vexio",
    "Vinetic",
    "Volantis",
    "Vunati",
    "Valure",
    "Verito",
    "Vional"
  ],
  "parameters": {
    "count": 8,
    "minLength": 5,
    "maxLength": 8,
    "tone": "brand",
    "startsWith": "v",
    "prefix": "",
    "suffix": "",
    "exclude": [
      "x"
    ],
    "generationParams": {
      "probVowelCluster": 0.2,
      "probConsonantCluster": 0.25,
      "probStartWithVowel": 0.3,
      "probAddFinalCluster": 0.4
    }
  }
}