dom

by zachwill

zachwill / dom

Check domain name availability from the command line.

208 Stars 26 Forks Last release: Not found 69 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

dom

An easy-to-use command line utility for checking domain name availability using Domainr's JSON API.

Example of dom in action

Setup requires two things:

  1. Installing dom
  2. Obtaining an API key

Installation

The simplest method is to install the package through

pip
by running:
pip install dom

Alternatively, you can install from source:

  1. Clone the repo:

    $ git clone [email protected]:zachwill/dom.git

    $ cd dom
  2. Run the following command to install:

    python setup.py install

Get an API key for Domainr

Due to abuse of their API, Domainr now requires an API key for each user. This key can be obtained through one of the following ways:

  1. Get a Rapidapi Domainr API key from Rapidapi Note: While it is free up to 10,000 calls/mo., you are required to submit a valid credit card to cover any requests over the free limit.
    • You can use something like Privacy.com to create a credit temporary card. I've been told that some banks offer a similar feature as well.
  2. Contact Domainr at
    [email protected]
    to get a personal use client ID, as detailed here

Once you have obtained one of the two types of keys, insert either the Rapidapi API key or the Client ID into your local environment:

$ export DOMAINR_RAPIDAPI_KEY={your-rapidapi-key}
or
$ export DOMAINR_CLIENT_ID={your-client-id}

You can do this manually everytime before running dom, or you can search for how to do this on login. Digital Ocean has an excellent guide here: How To Read and Set Environmental and Shell Variables on a Linux VPS.

Note that in the event that both keys are present, dom will default to using the Rapidapi Key.

Optional Flags

The optional

--ascii
flag can be used to look up domain availability without the use of the Unicode characters.
dom --ascii zachwill

X zachwill.com A zachwill.net A zachwill.org A zachwill.co X za.ch X z.ac

The

--available
flag only shows domain names that are currently available:
dom --available zachwill

✓ zachwill.net ✓ zachwill.org ✓ zachwill.co ✓ zachwill.io ✓ zachwill.me

The

--no-suggest
flag only check the exact domain names that are in query:
dom --no-suggest zachwill.com

✗ zachwill.com

And, the

--tld
flag only shows top-level domains:
dom --tld zachwill

✗ zachwill.com ✓ zachwill.net ✓ zachwill.org

Deploying

You won't need to worry about this, but since the Python

upload
command is so obtuse, I'm going to keep it here:
python setup.py sdist bdist_egg upload

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.