navbar
javascript

Domain Suggestions

POST /v1/domain_suggestions  OpenAPI download openAPI file

/*
 * GET or POST to /v1/suggestions
 */
let requestData = {
  str: 'helloworld', // required
  tld: 'com', // optional,
  use_word_hacks: true, // optional, boolean
  use_phrase_hacks: true, // optional, boolean
  use_spellcheck: true, // optional, boolean
  use_dashes: false, // optional, boolean
  use_before: true, // optional, boolean
  tlds_num: 30, // optional, number
}

/*
 * OUTPUT (JSON format):
 */
{
    "string_original": "hellowrld",
    "tld": "com",
    // spell-checked, chunked input
    "string": "hello world",
    // suggested TLDs, ordered by relevance
    "tlds": [
        "world", "fyi", "earth", "info", "global", "travel", "international", "us", "eco"
    ],
    // suggested names, grouped by type of modification
    "domains": {
        "tld": [
            "hellowrld .fyi",
            "hellowrld .earth",
            "hellowrld .info",
            "hellowrld .global"
        ],
        "name": [
            "hola society .com",
            "howdy .earth",
            "well hello .world",
            "shalom .travel",
            "earth .eco",
            "hello there .earth",
            "society .space"
        ],
        "word hack": [
            "worlda .eco",
            "planet .io",
            "orbus .org"
        ],
        "phrase hack": [
            "get hellowrld .eco",
            "my hellowrld .app",
            "hellowrld online .com"
        ],
        "all": [
            "hellowrld .fyi",
            "hola society .com",
            "worlda .eco",
            "get hellowrld .eco",
            "hellowrld .earth",
            "howdy .earth",
            "planet .io",
            "my hellowrld .app",
        ]
    }
}

Get it at RapidAPI

Demo at Besta.Domains

Request:

POST data to http://api.besta.domains/v1/suggestions, using content-type="application/json".
You may also send variables as "URL Query parameters".
Example: We choose to send "str" and "tld" in the URL (POST TO /v1/suggestions?str=helloworld&tld=com), and all other options as POST data.

POST data or URL params:

Note: if the str ends with a TLD, like "goodnews.app", then this TLD, parsed from str will be used, even if you specified a tld value. So, you do not have to worry about parsing the tld on your end. We will do it for you.

Response:

See code example to the top/right. It is a shortened example of response data for input ?str=helloworld&tld=com or ?str=helloworld.com. The suggestions are grouped by category inside response data.domains. You may mix together the categories yourself, or use our aggregated data.domains.all list. To get simply a list of suggested TLDs, use data.tlds.

More options coming soon:

 

All new features will be backwards compatible. Contact us to learn about upcoming features, and to suggest some that are important to you.

Domain Availability

POST /v1/domain_availability  OpenAPI download openAPI file

/*
 * Status code legend:
    -1 = unknown, not able to check
    0 = new, did not check
    1 = unavailable
    2 = available
    3 = registry premium (buy it now for higher price than such TLD normally sells for)
    4 = aftermarket premium (buy it now or make an offer, also could be in an auction)
    5 = registry super-premium (must submit offer, more expensive than regular premium SLDs)
    6 = unavailable, but expiring soon
 */

/*
 * POST to /v1/availability:
 */
let postData = {
  "method": "domainr",
  "domains": [
    "premium.net",
    "besta.domains",
    "greata.domains",
    "perfect.domains",
    "true.domains",
    "best.domains",
    "new.domains"
  ]
}

/*
 * RESPONSE DATA (use Domainr.com API)
 * We have engineered an abstration layer on top of Domainr.com.
 * Our server checks many domains in parallel, instead of
 * one by one. So, get results upto 100 times faster!
 */
{
  "method": "domainr",
  "status": {
    "premium.net": 4, // aftermarket
    "besta.domains": 1, // not available
    "greata.domains" 2, // available
    "perfect.domains": 3, // registry premium
    "true.domains": 4, // aftermarket
    "best.domains": 1, // not available
    "new.domains": 5 // registry super-premium
  }
}

/*
 * RESPONSE DATA (use whois/nameservers) (COMING SOON)
 * This will be able to find which aftermarket service the
 * domain is listed in. Also, most reliable at telling if the
 * domain is listed in an aftermarket. Also, it can tell if
 * a domain name is expiring soon, and return the expiry date.
 * Unfortunately, it can NOT reliably tell if a domain is
 * simply "available to register".
 */
{
  "method": "whois/nameservers",
  "status": {
    "premium.net": 4, // aftermarket
    "besta.domains": 1, // not available
    "greata.domains" -1, // unknown
    "perfect.domains": 3, // registry premium
    "true.domains": 4, // aftermarket
    "best.domains": 4, // aftermarket
    "new.domains": 5 // registry super-premium
  },
  "aftermarket": {
    "premium.net": "sedo.com",
    "true.domains": "auctions.godaddy.com",
    "best.domains": "dan.com",
    "new.domains": "name.com",
  }
  "expiration": {
    // if a domain is expiring soon, it will be
    // included here just like data.aftermarket
  }
}

Get it at RapidAPI

Demo at Besta.Domains

Request:

POST to http://api.besta.domains/v1/availability, using content-type="application/json".

Send Data:

Response:

See code sample above/right for an example response. You send an array of domains. We return the same domains, in an object. Value = status code.

Value for each domain is one of these codes:
-1: unknown, not able to check
0: new, did not check
1: unavailable
2: available
3: registry premium (buy it now for higher price than such TLD normally sells for)
4: aftermarket premium (buy it now or make an offer, also could be in an auction)
5: registry premium marketed (must submit offer, more expensive than regular premium SLDs)
6: unavailable, but expiring soon (includes expiration date - check data.expiration)

-1: unknown, not able to check 0: new, did not check 1: unavailable 2: available 3: registry premium (buy it now for higher price than such TLD normally sells for) 4: aftermarket premium (buy it now or make an offer, also could be in an auction) 5: registry premium marketed (must submit offer, more expensive than regular premium SLDs) 6: unavailable, but expiring soon (includes expiration date - check data.expiration)

More options coming soon:

Specify the "method", which strategy to use, to check availability:

  1. "domainr" - (default) Domainr.com API. Fastest. We have engineered an abstration layer on top of the excellent Domainr.com API. Our server checks many domains in parallel, instead of one by one. So, you get results upto 100 times faster!
  2. "whois/nameservers" - (in development, not ready) Fast. Most reliable at telling if the domain is listed in an aftermarket. It can actually tell you which aftermarket! For most domains it can check if expiring soon and return the date of expiration. Unfortunately, it can NOT reliably tell if a domain is simply "available to register". So, it must be used in conjunction with another method.
  3. "registry/epp" - (coming in the future) Slower. Currently getting accredited and registered with various registries. This is coming soon. We'll be able to use the same tools which registrars use.

Text Analysis

Access the largest thesaurus database + a growing collection of natural-language-processing tools.

Spellcheck + Tokenization + Wordbreak

Break up a long string of characters into words. Get parts-of-speech and synonyms about each token. Optionally, perform spellcheck using Microsoft AND Google. This adds a few hundred milliseconds.

OpenAPI download openAPI file   Get it at RapidAPI

Synonyms + Word info

Get accurate information about a word or phrase. Synonyms, sentiment analysis, parts of speech, root words, acronyms, abbreviations, before/after, domains, etc.

OpenAPI download openAPI file   Get it at RapidAPI

Explore the endpoints at: https://wordio.co

About

Our infrastructure

Building websites for 12 years now, we've developed a state-of-the-art infrastructure and codebase. Our APIs are currently hosted in the USA East region, near NYC, for fast access to North America and Europe. We manage a cloud of load-balanced servers, ready to scale at any time. Coming soon, we will upgrade to a world-wide geo-distributed network - to be as close as possible to your servers and users - to provide the fastest and most reliable service!

Who we are

A husband and wife team, based in Kansas City, MO (USA). 👨🏼‍💻👩🏽‍💼 Combining our talents, we were able to make the world's best English language thesaurus. Paul built some advanced custom admin tools. Samira used them to comb through and edit thousands of words. Contact us for a demo.

We met in Utah. Love those mountains and sunsets! ⬆ We met in Utah. Love those mountains and sunsets!

Paul Shorey (paulshorey.com) has been making websites and apps for 12 years. JavaScript, UI design, front-end, back-end, systems and databases. Paul has a BFA in fine art, but has embraced software development as his medium of choice. Programming is creative, and very powerful. You can create something from nothing! When not coding, he enjoys building light fixtures, growing microgreens, and doing adventure sports.

Samira Ali has a Bachelors in Sociology. She has worked at several non-profits, and has started many of her own initiatives. She has worked in tech and medicine as well. She speaks several languages, and has been a part of a very diverse range of cultures. Samira has been instrumental in editing the thesaurus, including adding positive synonyms for traditionally negative words like "black". She also flagged many culturally negative and insensitive words which IBM's and our own AI algorithms have missed.

We're both inspired by this crazy adventure that is life. Paul successfully immigrated from Russia, and Samira is a refugee from Africa. We're thankful for where we are now, and are moving toward securing a prosperous future through hard work and the pursuit of excellence. Looking forward to meeting you.

Let's get in touch (contact us). Currently looking for partners, mentors, and ofcourse clients.

Why NLP?

It stands for Natural Language Processing (or Neuro Linguistic Programming). A branch of AI. Paul has worked at an AI company for the last 2 years before starting this. This venture, however, is not as ambitious as most AI companies. We're not trying to change the world or create sentient software. We just want the world to have more quality UIs and APIs.

The reason this happened, is because in 2019, Paul set out to make a domain name suggestions app. He was disappointed with the quality of publicly available APIs and datasets. Thesaurus resources were not reliable, or did not have an API. So, he set out to make his own. He got carried away, and accidentally made the best English thesaurus in the world.

It was a great learning experience, and now we have a database of 500,000 words, about 200,000 of which have good synonyms. As a reference, a native English speaker knows from 20,000 to 35,000 words, including slang. Many of the others are medical terms. We're currently brainstorming how this can be used in medical applications - perhaps to refine search results in sites like WebMD.

We also ended up making by far the best domain name suggestion tool. Please try it: https://besta.domains or use our API. Our program generates hundreds of name phrases, and pairs them with the most relevant TLDs (extensions). There are currently 1000+ new TLD extensions which people don't even know exist, so this service is very useful. We then check for the status (availability) of each domain name. No more typing in one domain name at a time, and hoping that it's available. Our app gives you hundreds of similar names. Some of them turn out to be available and pretty good!

It's improving every day!

Our products are new and rapidly improving. If you find anything broken, please let us know. If you would like a feature or have any advice for us at all, please contact us.

This venture is long-term. We'll continue to support it as long as we have customers. It may take a long time to become successful. That's ok. This is a labor of love.

Please try our APIs, and compare to other providers. You will not be disappointed.

If our APIs are not as good as what you're currently using, please let us know. It will help us improve. Sometimes it may be a simple configuration which dramatically lowers or improves results for a particular use case. Thank you for your support and feedback!

Contact

More about us: wordio.co/about