Introduction

Nomaine's API can be used free of charge to generate domain names in the same way you would do on the website.

To use the API, you need to request an API key with a valid email. You can request it here

This API is still in Beta. To keep the experience enjoyable for everybody we have to put a small number of restrictions. These restrictions may ease up as we learn how our system handles this additionnal load. Your feedback is very welcome!

Free account

  • Non-commercial use only
  • Limited to 1000 API requests per month
  • Availability of a domain name is served from cache

Premium account

  • Commercial use allowed
  • Up to 10000 API requests per month
  • Up to 1000 true domain availability checks using WHOIS per month
  • Availability of a domain name is served from cache (fast) or checked at WHOIS level (slower)
  • Automated ordering coming soon, contact us if you are in a hurry or if you need more

If you have comments on the API, contact us at

General URL format

/api/:version/:key/:format/:method/:mandatory_param1/:mandatory_param2/:option_name1/:option_value1

:version

  • v1

:key

:format

  • xml
  • json

:method

  • proposals

Error handling :

  • 404 : Invalid API key or out of quota
  • 500 : Invalid parameters (theme, TLD)

Domain proposals

parameters

/api/v1/:format/proposals/:theme/:tld/:option_name1/:option_value1

:format

  • xml
  • json

:theme

  • en-US : english
  • fr : french
  • spanish : spanish
  • italian : italian
  • ogerman : german
  • swedish : swedish
  • gaelic : gaelic
  • dutch : dutch
  • portuguese : portuguese
  • rock-groups : rock bands
  • movies : movies
  • cities-uk : cities (UK)
  • cities-us : cities (USA)
  • cities-french : cities (french)
  • colors : colors
  • fruits : fruits
  • elemental : elemental
  • hacker : hacker
  • male-names : male (english)
  • male-french : male (french)
  • male-rpg : male (rpg)
  • male-japanese : male (japan)
  • female-names : female (english)
  • female-french : female (french)
  • female-rpg : female (rpg)
  • female-japanese : female (japan)
  • latin : latin
  • animals : animals
  • bacteria : bacteria
  • minerals : minerals
  • molecules : molecules
  • fungi : fungi
  • machines : hostname
  • stars : stars
  • beers : beers
  • martial-arts : martial arts
  • bad-words : bad words (NSFW)

:tld

  • com
  • net
  • org
  • fr
  • be
  • eu
  • info
  • biz
  • name
  • asia
  • tel
  • co.uk
  • org.uk
  • me
  • us
  • cn
  • tw
  • mobi
  • pro
  • at
  • bz
  • cc
  • ch
  • co
  • cz
  • de
  • es
  • hn
  • im
  • in
  • it
  • nl
  • nu
  • pl
  • sc
  • tv
  • vc
  • io

:option_name

  • whois : 1 to check availability at WHOIS level (Premium only)
  • min : minimum number of syllabes
  • max : maximum number of syllabes
  • prefix : string to use as prefix (use one syllable for best results, hint: "red" is not a syllable, "ed" is)
  • suffix : string to use as suffix (use one syllable for best results)
  • limit : number of results (max 25)

Example: http://nomaine.com/api/v1/xml/proposals/rock-groups/com/suffix/ed/min/4

results

XML

    <proposals>
      <proposal token="2fd5c03e06d392378daa9e2c1c20b4b42ec840df">
        <status>unknown</status>
        <name>trowered.com</name>
        <sld>trowered</sld>
        <tld>com</tld>
      </proposal>
    </proposals>
      <proposal token="86f14405b5892d6c4ed120ea8e313f9e9cfb934e">
        <status>unknown</status>
        <name>gangstered.com</name>
        <sld>gangstered</sld>
        <tld>com</tld>
      </proposal>
    </proposals>
    

JSON

    [
    {
      "token": "3d7301888b7cf51d85435b70bdccbfaf72505852",
      "status": "unknown", 
      "name": "dirtfished.com", 
      "sld": "dirtfished", 
      "tld": "com", 
    }, 
    {
      "token": "4ca7d32fa206c552104c34e22e25753ade506153",
      "status": "free", 
      "name": "pavemented.com", 
      "sld": "pavemented", 
      "tld": "com", 
    }, 
    ]
    
  • proposals : array of results
  • proposal : one result
    • token : unique identifier for this domain (future usage)
  • status
    • tested_free : available (Premium only)
    • free : probably available
    • taken : already registered
    • unknown : no information about availability
  • name : domain name
  • sld : domain name without the TLD (extension)
  • tld : TLD only (extension)