pricing background

Reverse Whois API Documentation

Reverse WHOIS API

ASK AI
The Reverse WHOIS API searches our 4.1B+ record database backward. You provide an owner attribute and receive every domain connected to it. Four search dimensions are supported: email address, registrant name, company name, and domain keyword.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Important References

  • For details on request limits and handling rate limiting, refer here
  • For a complete overview of API credit consumption and usage, refer here

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    The value of whois will be 'reverse'.
  • keyword
    The domain keyword for requested whois.
  • email
    The email for requested WHOIS (exact or regex match).
  • owner
    The owner name for requested whois.
  • company
    The company name for requested whois.
Optional
  • mode
    Two modes are available mini & default.
  • exact
    The 'exact' parameter can be either 'true' or 'false'.
  • page
    For getting next or desired page of WHOIS info.
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
total_Result
Total number of historical WHOIS records returned
number
3
total_Pages
Total number of pages available for pagination
number
1
current_Page
Current page number of the response
number
1
whois_domains_historical
List of historical WHOIS records for domains
array
num
Record sequence number
number
1
status
Indicates if the WHOIS record retrieval was successful
boolean
true
domain_name
Domain name
string
whoisfreaks.com
query_time
Timestamp when WHOIS query was executed
string (YYYY-MM-DD HH:mm:ss)
2024-04-02 17:45:50
whois_server
WHOIS server used for the query
string
whois.verisign-grs.com
create_date
Domain creation date
string (YYYY-MM-DD)
2019-03-19
update_date
Last updated date of domain record
string (YYYY-MM-DD)
2024-02-18
expiry_date
Domain expiration date
string (YYYY-MM-DD)
2025-03-19
domain_registrar
Registrar information for the domain
iana_id
IANA registrar ID
string
1068
registrar_name
Name of registrar
string
namecheap, inc.
whois_server
Registrar WHOIS server
string
whois.namecheap.com
website_url
Registrar website URL
string
http://www.namecheap.com
email_address
Registrar abuse/support email
string
[email protected]
phone_number
Registrar contact phone number
string
+1.9854014545
reseller_contact
Reseller contact details (if available)
name
Reseller name
string
NAMECHEAP INC
email_address
Reseller email
string
phone
Reseller phone number
string
registrant_contact
Registrant contact details
name
Registrant name
string
Redacted for Privacy
company
Registrant company
string
Privacy service provided by Withheld for Privacy ehf
street
Street address
string
Kalkofnsvegur 2
city
City
string
Reykjavik
state
State/region
string
Capital Region
zip_code
Postal code
string
101
country_name
Country name
string
Iceland
country_code
Country code
string
IS
email_address
Contact email address
string
[email protected]
phone
Contact phone number
string
+354.4212434
administrative_contact
Administrative contact details
technical_contact
Technical contact details
billing_contact
Billing contact details
name_servers
List of name servers for the domain
array
dns8.cloudns.net
domain_status
Domain status flags
array
clientTransferProhibited
registry_data
Registry-level WHOIS data
domain_name
Domain name from registry
string
WHOISFREAKS.COM
query_time
Registry query time
string (YYYY-MM-DD HH:mm:ss)
2024-04-02 17:45:50
whois_server
Registry WHOIS server
string
whois.verisign-grs.com
create_date
Registry creation date
string (YYYY-MM-DD)
update_date
Registry update date
string (YYYY-MM-DD)
expiry_date
Registry expiry date
string (YYYY-MM-DD)
domain_registrar
Registrar info in registry data
name_servers
Name servers from registry
array
dns8.cloudns.net
domain_status
Domain status from registry
array
clientTransferProhibited