Skip to content

promptapi/whois-py

Repository files navigation

Python Version Code style: black Build Status

Prompt API - Whois API - Python Package

pa-whois is a python wrapper for whois api

Requirements

  1. You need to signup for Prompt API
  2. You need to subscribe whois api, test drive is free!!!
  3. You need to set PROMPTAPI_TOKEN environment variable after subscription.

then;

$ pip install pa-whois

Example Usage

Let’s try with check endpoint:

from whois import Whois

who = Whois()
who.check('promptapi.com')
# returns dict
# {'result': 'registered', 'status': 200}

# or
check_result = who.check('promptapi.com')
print(check_result)
# {'result': 'registered', 'status': 200}

who.check('promptapi.comaaaaaaaaaaaaaaaa')
# {'error': 'TLD not supported', 'status': 400}

who.check('promptapi-testing-domain.com') 
# {'result': 'available', 'status': 200}

Now, let’s try with query endpoint:

from whois import Whois

who = Whois()
who.query('promptapi-testing-domain.com')
# {'error': 'No match for promptapi-testing-domain.com', 'status': 404}

who.query('promptapi.com')
#{'result': {'domain_name': 'PROMPTAPI.COM',
#  'registrar': 'NameCheap, Inc.',
#  'whois_server': 'whois.namecheap.com',
#  'referral_url': None,
#  'updated_date': '2020-05-27 22:19:36',
#  'creation_date': '2020-04-19 15:11:52',
#  'expiration_date': '2021-04-19 15:11:52',
#  'name_servers': ['APOLLO.NS.CLOUDFLARE.COM', 'MARJORY.NS.CLOUDFLARE.COM'],
#  'status': 'clientTransferProhibited https://icann.org/epp#clientTransferProhibited',
#  'emails': 'abuse@namecheap.com',
#  'dnssec': 'unsigned',
#  'name': None,
#  'org': None,
#  'address': None,
#  'city': None,
#  'state': None,
#  'zipcode': None,
#  'country': None},
# 'status': 200}

License

This project is licensed under MIT


Contributer(s)


Contribute

All PR’s are welcome!

  1. fork (https://github.com/promptapi/whois-py/fork)
  2. Create your branch (git checkout -b my-feature)
  3. commit yours (git commit -am 'Add awesome features...')
  4. push your branch (git push origin my-feature)
  5. Than create a new Pull Request!

This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.