How to lookup domain WHOIS in Ruby

Cloudmersive
3 min readAug 10, 2019

--

Today we will be looking at the easy way to get the WHOIS for a domain name. The first step is to add a reference to our API client in our Gemfile.

gem 'cloudmersive-validate-api-client', '~> 1.3.2'

Then call domain_post with our desired domain.

# load the gem
require 'cloudmersive-validate-api-client'
# setup authorization
CloudmersiveValidateApiClient.configure do |config|
# Configure API key authorization: Apikey
config.api_key['Apikey'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['Apikey'] = 'Bearer'
end
api_instance = CloudmersiveValidateApiClient::DomainApi.newdomain = "domain_example" # String | Domain name to check, for example \"cloudmersive.com\". The input is a string so be sure to enclose it in double-quotes.begin
#Get WHOIS information for a domain
result = api_instance.domain_post(domain)
p result
rescue CloudmersiveValidateApiClient::ApiError => e
puts "Exception when calling DomainApi->domain_post: #{e}"
end

If, for example, we enter google.com as our input, we will get this as a response:

{
"ValidDomain": true,
"WhoisServer": "whois.verisign-grs.com",
"RawTextRecord": "Domain Name: google.com\r\nRegistry Domain ID: 2138514_DOMAIN_COM-VRSN\r\nRegistrar WHOIS Server: whois.markmonitor.com\r\nRegistrar URL: http://www.markmonitor.com\r\nUpdated Date: 2018-02-21T10:45:07-0800\r\nCreation Date: 1997-09-15T00:00:00-0700\r\nRegistrar Registration Expiration Date: 2020-09-13T21:00:00-0700\r\nRegistrar: MarkMonitor, Inc.\r\nRegistrar IANA ID: 292\r\nRegistrar Abuse Contact Email: abusecomplaints@markmonitor.com\r\nRegistrar Abuse Contact Phone: +1.2083895740\r\nDomain Status: clientUpdateProhibited (https://www.icann.org/epp#clientUpdateProhibited)\r\nDomain Status: clientTransferProhibited (https://www.icann.org/epp#clientTransferProhibited)\r\nDomain Status: clientDeleteProhibited (https://www.icann.org/epp#clientDeleteProhibited)\r\nDomain Status: serverUpdateProhibited (https://www.icann.org/epp#serverUpdateProhibited)\r\nDomain Status: serverTransferProhibited (https://www.icann.org/epp#serverTransferProhibited)\r\nDomain Status: serverDeleteProhibited (https://www.icann.org/epp#serverDeleteProhibited)\r\nRegistrant Organization: Google LLC\r\nRegistrant State/Province: CA\r\nRegistrant Country: US\r\nAdmin Organization: Google LLC\r\nAdmin State/Province: CA\r\nAdmin Country: US\r\nTech Organization: Google LLC\r\nTech State/Province: CA\r\nTech Country: US\r\nName Server: ns4.google.com\r\nName Server: ns1.google.com\r\nName Server: ns2.google.com\r\nName Server: ns3.google.com\r\nDNSSEC: unsigned\r\nURL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net/\r\n>>> Last update of WHOIS database: 2019-08-09T12:27:04-0700 <<<\r\n\r\nFor more information on WHOIS status codes, please visit:\r\n https://www.icann.org/resources/pages/epp-status-codes\r\n\r\nIf you wish to contact this domain’s Registrant, Administrative, or Technical\r\ncontact, and such email address is not visible above, you may do so via our web\r\nform, pursuant to ICANN’s Temporary Specification. To verify that you are not a\r\nrobot, please enter your email address to receive a link to a page that\r\nfacilitates email communication with the relevant contact(s).\r\n\r\nWeb-based WHOIS:\r\n https://domains.markmonitor.com/whois\r\n\r\nIf you have a legitimate interest in viewing the non-public WHOIS details, send\r\nyour request and the reasons for your request to whoisrequest@markmonitor.com\r\nand specify the domain name in the subject line. We will review that request and\r\nmay ask for supporting documentation and explanation.\r\n\r\nThe data in MarkMonitor’s WHOIS database is provided for information purposes,\r\nand to assist persons in obtaining information about or related to a domain\r\nname’s registration record. While MarkMonitor believes the data to be accurate,\r\nthe data is provided \"as is\" with no guarantee or warranties regarding its\r\naccuracy.\r\n\r\nBy submitting a WHOIS query, you agree that you will use this data only for\r\nlawful purposes and that, under no circumstances will you use this data to:\r\n (1) allow, enable, or otherwise support the transmission by email, telephone,\r\nor facsimile of mass, unsolicited, commercial advertising, or spam; or\r\n (2) enable high volume, automated, or electronic processes that send queries,\r\ndata, or email to MarkMonitor (or its systems) or the domain name contacts (or\r\nits systems).\r\n\r\nMarkMonitor.com reserves the right to modify these terms at any time.\r\n\r\nBy submitting this query, you agree to abide by this policy.\r\n\r\nMarkMonitor is the Global Leader in Online Brand Protection.\r\n\r\nMarkMonitor Domain Management(TM)\r\nMarkMonitor Brand Protection(TM)\r\nMarkMonitor AntiCounterfeiting(TM)\r\nMarkMonitor AntiPiracy(TM)\r\nMarkMonitor AntiFraud(TM)\r\nProfessional and Managed Services\r\n\r\nVisit MarkMonitor at https://www.markmonitor.com\r\nContact us at +1.8007459229\r\nIn Europe, at +44.02032062220\r\n--\r\n",
"CreatedDt": null
}

And it’s as simple as that.

--

--

Cloudmersive
Cloudmersive

Written by Cloudmersive

There’s an API for that. Cloudmersive is a leader in Highly Scalable Cloud APIs.

No responses yet