Skip to main content

Python wrapper for Prompt API's Whois API

Project description

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.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pa-whois-0.1.0.tar.gz (4.0 kB view hashes)

Uploaded Source

Built Distribution

pa_whois-0.1.0-py3-none-any.whl (4.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page