Loading
Loading
Search over 1 billion domains and 3.5 billion WHOIS records to find all domain names linked to any owner name, company, email address, or keyword. Supports keyword, email, owner, and company lookups with pagination and two response modes.
The Reverse WHOIS Lookup API offers two modes: Default Mode returns up to 50 complete WHOIS records per page, while Mini Mode returns up to 100 records with only essential fields per page.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters. At least one of keyword, email, owner, or company is required.
keywordoptionalStringkeyword search term in case of reverse WHOIS by keyword
emailoptionalStringemail search term in case of reverse WHOIS by email address (case-insensitive exact or regex match; * wildcard supported)
owneroptionalStringregistrant / owner name search term in case of reverse WHOIS by registrant / owner
companyoptionalStringregistrant company / organization search term in case of reverse WHOIS by organization / company
exactoptionalBooleandefault: falseAccepts 'true' or 'false'. 'true' returns only exact matches for keyword, owner/registrant, or company searches. 'false' returns all matches (default).
modeoptionalStringdefault: default"default" for Complete WHOIS data and "mini" for Only important fields of each matching domain.
pageoptionalIntegerdefault: 1page no. to retrieve paginated results.
A successful request returns a 200 OK response with a JSON object containing the top-level fields listed below. See the response preview on the right for the full JSON structure.
total_ResultTotal results found across the query.
total_PagesTotal number of pages (50 records per page in default mode, 100 in mini mode).
current_PageCurrent number of page.
whois_domains_historicalList of historical WHOIS responses matching the criteria.
List of domain's WHOIS records. Each object in default mode contains the following fields:
numShows the number of the record in the array.
statusAlways true.
domain_nameDomain name which was queried.
query_timeThe timestamp when the query was made. (format YYYY-MM-DD HH:mm:ss)
whois_serverThe WHOIS server that provided the domain information.
domain_registeredDetermines whether the requested domain is registered/not registered or is restricted. Possible values are:
create_dateDate when the domain was initially registered (format: YYYY-MM-DD).
update_dateThe date (format: YYYY-MM-DD) of the most recent update to the domain registration.
expiry_dateThe date (format: YYYY-MM-DD) when the domain registration will expire if not renewed.
domain_registrarRegistrar information.
domain_registrar.iana_idThe IANA (Internet Assigned Numbers Authority) ID of the registrar managing the domain. This unique identifier is assigned to domain registrars by the IANA to ensure their recognition and regulation in the domain name system.
domain_registrar.registrar_nameThe name of the registrar managing the domain.
domain_registrar.whois_serverThe WHOIS server that provided the domain information.
domain_registrar.website_urlThe website URL of the registrar managing the domain.
domain_registrar.email_addressThe email address of registrar contact.
domain_registrar.phone_numberThe phone number of the registrar managing the object.
reseller_contactThird party between the registrar and registrant.
reseller_contact.nameName of the reseller.
reseller_contact.email_addressEmail address of the reseller.
reseller_contact.phonePhone number of the reseller.
registrant_contactContact details of the domain's owner.
administrative_contactContact details of the domain administrator.
technical_contactContact details of the technical person.
billing_contactContact details of the person handling billing operations.
name_serversName servers of the domain.
domain_statusStatus of the domain.
whois_raw_domainRaw WHOIS data for the domain.
registry_dataRegistry data of the domain.
Each contact object contains the following fields:
nameName of the person.
companyName of the company.
streetStreet name.
cityCity of the responsible person.
stateState of the responsible person.
zip_codeZip code of the responsible person.
country_nameCountry name of the responsible person.
country_codeCountry code of the responsible person.
email_addressEmail address of the responsible person.
phonePhone number of the responsible person.
faxFax of the responsible person.
mailing_addressMailing address of the responsible person.
The registry_data object contains the following fields:
domain_nameName of the domain.
query_timeThe timestamp when the query was made (format: YYYY-MM-DD HH:mm:ss).
whois_serverThe WHOIS server that provided the domain information.
domain_registeredDetermines whether the requested domain is registered/not registered or is restricted. Possible values are:
create_dateDate when the domain was initially registered (format: YYYY-MM-DD).
update_dateThe date (format: YYYY-MM-DD) of the most recent update to the domain registration.
expiry_dateThe date (format: YYYY-MM-DD) when the domain registration will expire if not renewed.
name_serversName servers of the domain.
domain_statusStatus of the domain.
whois_raw_registryRaw WHOIS data from the registry.
domain_registrarRegistrar information.
domain_registrar.iana_idThe IANA (Internet Assigned Numbers Authority) ID of the registrar managing the domain. This unique identifier is assigned to domain registrars by the IANA to ensure their recognition and regulation in the domain name system.
domain_registrar.registrar_nameThe name of the registrar managing the domain.
domain_registrar.whois_serverThe WHOIS server that provided the domain information.
domain_registrar.website_urlThe website URL of the registrar managing the domain.
domain_registrar.email_addressThe email address of the registrar contact.
domain_registrar.phone_numberThe phone number of the registrar managing the object.
In mini mode, each object contains only the essential fields:
numNumber of the record.
domain_nameName of the associated domain.
create_dateDate the domain was created. (Format: YYYY-MM-DD)
update_dateDate the domain was last updated. (Format: YYYY-MM-DD)
expiry_dateDate the domain will expire if not renewed. (Format: YYYY-MM-DD)
nameName of the person who registered the domain.
emailEmail of the person who registered the domain.
companynameName of the company to which the domain name is associated.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Please pass param value.
Record not found.
Service is unavailable.
Request is timed-out.