Whois Lookup API

Whois API provides well-parsed and structured information about domain names, including registration date, expiry date, registrar information, owner details, and host name server information. This comprehensive data is invaluable for making informed decisions in various areas such as marketing outreach, phishing and scam investigation, brand protection, and building advanced search techniques. By understanding the ownership and registration details, businesses can tailor their marketing strategies more effectively, enhance security measures against potential threats, protect their brand from infringements, and develop sophisticated search algorithms to track and analyze domain-related data.

Whois History Lookup API

The Whois history API offers access to exclusive historical Whois data, including details like renewal dates, host name servers, registrant information, and registrar records. Our domain Whois database is continually expanding, with millions of distinct whois records being added daily. This API enables users to delve into historical Whois records for domain names presented in JSON or XML formats.

Reverse Whois Search API

Reverse whois lookup API allows you to search domain information by owner name, email address, domain keyword or company name backed by our terabytes of Whois data. It can be used for domain co-relation, brand monitoring, domain authority scoring, and B2B marketing.

Bulk Whois Lookup API

The Bulk Whois Lookup API allows you to perform whois lookups for multiple domain names in a single query, supporting up to 100 domains at a time. This API can be used for both live and historical whois records. You can upload a file containing 3 million domain names with one domain per line on our billing dashboard. Once the lookup is complete, we will send you an email with a link to download the whois data in CSV format.

Features

live-schedule
Real-time data

Fetch real-time whois domain data directly from whois servers using live domain whois lookup, IP whois lookup or ASN whois lookup based on domain name, IP or ASN, respectively providing immediate and accurate domain registration information.

Domain's Past Information

Access historical domain whois records using historical whois lookup from our comprehensive database, offering valuable insights into past domain ownership and registration details.

Domain Ownership Details

Use whois reverse search lookup to retrieve comprehensive domain ownership details, offering insights into the registrant's information, registration dates, and more for thorough domain analysis.

Keyword based lookup

Keyword-based lookup in reverse whois searches enables you to discover domains containing specific terms or phrases, helping you identify relevant domains quickly and accurately.

Email based lookup

Email-based lookup in reverse whois search allows you to find all domains associated with a specific email address, providing a comprehensive view of an entity's domain portfolio.

Registrant based lookup

Use registrant-based lookup in reverse whois search lookup to identify all domains registered by a particular individual or organization, enhancing your investigation and monitoring capabilities.

Company based lookup

Perform a reverse whois search to find domain ownership details linked to a specific company, enabling you to discover all domains registered by that entity efficiently.

Bulk domain search

Access detailed domain information for up to 100 domains through our powerful API in a single request, or you can upload a file with up to 3 million domain names.

Consistent and Compressed data

Our service ensures data is both consistent and compressed, providing accurate and efficient information retrieval while optimizing storage and bandwidth usage for faster access and reduced costs.

Supported formats

Our service supports data retrieval in both JSON and XML formats, providing flexibility and compatibility with various applications and systems for seamless data integration and processing.

User-Friendly Web Tool

Navigate and utilize our intuitive web UI tool for a efficient experience powered by bulk whois API. Sign in and visit our billing dashboard for a seamless experience.

File Upload Support

Sign in now and upload a plain text or CSV file with up to 3 million domains for large-scale analysis in our billing dashboard's utility section. Our crawlers ensure accurate, comprehensive results delivered to your inbox.

Common Use Cases

Data Enrichment WhoisFreaks provides reliable and up-to-date details on all domains and websites on the internet. Using the information in your CRM, marketing campaigns, and audience profiles can help you create better customer experiences at an insightful level.
error-line
Domain Registration Issues Venturing into the world of domain registration can be a confusing experience. Whoisfreaks can help with managing your domains in the whois registry by providing a live public whois api to verify, track and troubleshoot problems that can arise.
Threat Intelligence Our Reverse Whois service is the top choice for threat intelligence and attack surface analysis. Utilize our live and historical Whois API to distinguish scammers from legitimate domains, conduct research, uncover hidden data, find customer information, and more.
Brand monitoring Protect your brand and intellectual property with our real-time Whois API. Analyze similar domains, typosquatting, and copyright violations. Safeguard your valuable assets with insights from our live and historical data, empowering you to take proactive measures.
Domain Portfolio Analysis Bulk WHOIS Lookup can help you analyze your domain portfolio quickly and efficiently. By gathering domain intelligence for all your domains in one go, you can identify potential issues such as outdated contact information or expiring domains.
Brand Protection Bulk WHOIS Lookup can be used to protect your brand by identifying potentially infringing domains or unauthorized use of your brand name. This information can help you take appropriate action to protect your brand identity.
Competitive Intelligence Bulk WHOIS Lookup can provide insights into your competitors' domains and online activities. By analyzing their domain portfolio, you can gain a better understanding of their online presence and marketing strategies.
Research & Due Diligence If you're in the market to purchase a domain or a business, Bulk WHOIS Lookup can help you conduct due diligence on the domains and their owners. You can gather valuable information such as contact details, domain history, and expiration dates.
Response
WHOIS Documentation

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.

API GET
https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=live&domainName=whoisfreaks.com

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    whoisThe value of whois will be 'live'.
    domainNameThe domainName for requested whois.
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
206 Partial response.
210 Cached response.
400 Invalid domain name parameters.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
403 Unavailable domain extension.
403 Domain belongs to an inactive TLD.
408 Unable to fetch whois data.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 206 210 400 401 403 408 412 413 429 500 503 504
Copy
OK

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.

API GET
https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=historical&domainName=google.com

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    whoisThe value of whois will be 'historical'.
    domainNameThe domainName for requested whois.
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
400 Invalid domain name parameters.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
404 Record not found.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 400 401 404 412 413 429 500 503 504
Copy
OK

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 the reset button in the billing dashboard.

Key Points:

Reverse whois lookup API lets you get whois records by keyword, email, registrant name or company.

  • Keyword search utilizes case-insensitive Pattern Matching search technique to search in our historical database. For example, "whoisfreaks" matches with any keyword that have the searched pattern like "mywhoisfreaks" and "whoisfreakscom".
  • Email search uses case-insensitive exact matching technique to search in our historical database. For example, "support@whoisfreaks.com" matches only with "support@whoisfreaks.com".
  • Registrant name or Company search use full-text search technique to search in our historical database. For example, "whoisfreaks" matched with "whoisfreaks", "whoisfreak", "whois", "mywhoisfreaks" and "whoisfreakscom".
API GET
https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&keyword=youtube
API GET
https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&email=abc@gmail.com
API GET
https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&owner=michal
API GET
https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&company=youtube

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    whoisThe value of whois will be 'reverse'.
    keywordThe domain keyword for requested whois.
    OR
    emailThe email for requested whois.
    OR
    ownerThe owner name for requested whois.
    OR
    companyThe company name for requested whois.
  • Optional
    mode
    Click
    Two modes are available mini & default.
    pageFor getting next or desired page whois info.
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
400 Please pass param value.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
404 Record not found.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 400 401 404 412 413 429 500 503 504
Copy
OK

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.

API GET
https://api.whoisfreaks.com/v1.0/ip-whois?apiKey=API_KEY&ip=8.8.8.8

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    ipIPv4 or IPv6 address for the requested whois.
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
206 Partial response.
400 Invalid IP address parameter.
400 Request-param 'format' is not valid.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
408 Unable to fetch whois data.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 206 400 401 408 412 413 429 500 503 504
Copy
OK

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.

API GET
https://api.whoisfreaks.com/v1.0/asn-whois?apiKey=API_KEY&asn=as56554

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
    asnThe ASN number with or without 'as' for requested whois. (e.g. as1009 or 1009)
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
206 Partial response.
400 Invalid ASN parameter.
400 Request-param 'format' is not valid.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
408 Unable to fetch whois data.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 206 400 401 408 412 413 429 500 503 504
Copy
OK

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.

API POST
{
    "domainNames":[
        "jfreaks.com",
        "whoisfreaks.com"
    ]
}
Copy

Query Parameters

  • Required
    apiKeyGet your API key from our billing dashboard.
  • Optional
    formatTwo formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.
Responses

200 OK
206 Partial response.
210 Cached response.
400 Please provide domainNames.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
403 Unavailable domain extension.
403 Domain belongs to an inactive TLD.
412 Exceeded the limit of api plan requests.
413 Exceeded maximum list size of 100.
413 Exceeded the limit of surcharge requests.
429 Maximum request limit reached.
500 Internal Server error.
503 Service is unavailable.
504 Request is timed-out.

Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
POST
Copy
Response
200 206 210 400 401 403 412 413 429 500 503 504
Copy
OK

Credit Usage API

You need credits in order to use DNS API. DNS Lookup service will charge 1 credit per successfull query for a domain. Historical DNS service will charge 2 credits per page. Reverse DNS service will charge 5 credits per page. Surcharge requests are only allowed to credits subscribers. You can fetch credits usage and remaining credits information through an API.

Request
GET
Copy
Response
XML JSON
Copy



FAQs

How can I request WHOIS information for thousands of domains?

You can request WHOIS information for thousands of domains using bulk whois domain lookup service with both an API and a user-friendly web interface for batch processing of upto 3 million domains. You can also use bulk whois domain lookup UI tool powered by bulk whois API. Here are the key features of the API and web interface:

Bulk WHOIS Lookup API:

  • Efficient Querying: Query up to 100 domains in a single request for speedy results.
  • Structured Data: Receive query results in popular XML and JSON formats, providing both parsed fields and raw texts.
  • Normalized Data: All WHOIS information is consistently parsed and normalized, making integration with your business processes seamless.

Bulk File Upload Web Interface:

  • Batch Processing: Support for a minimum of 101 domains up to a whopping 3 million domains in a single file upload.
  • Convenient Notifications: You'll be notified via email when the crawl is complete, with a download link for output files.
  • Data in CSV Format: Output files are delivered in compressed CSV format, containing all the essential WHOIS information.

What is Whois API and how does it work?

Whois API contains a big and well parsed Whois record data that provides all of the Whois information data to a wide-variety of industries against any domain name, such as domain registration details, domain owner email address and many more in JSON/XML formats. Live whois Lookup API crawl whois data in real time. We do not cache live whois records. Historical and reverse whois APIs provide data from our whois database.

How old do you have historical records?

We are providing Historical Whois data from 1986.

Is each Whois Record in historical database unique?

Yes, each whois record will be unique. We only save unique whois record of the domains.

What is the minimum number of domain names required for bulk whois?

Bulk whois API can support upto 100 domains. Bulk whois search through our billing dashboard by uploading file with one domain per line can support minimmum of 100 domains and maximum of 3M domains.

Will you charge on failed domains in bulk whois search utility?

We do not charge for failed domains. We only charge for found domains and charge for not found domains in case of live lookup.

How do you perform a search using "company" parameter on whois data in reverse API?

The company parameter enables you to search for domain whois data based on a publicly available company name. Simply input the company name, and the API will return domains associated with that company using search based query. For example, if you enter "meta", the API will return all domains that are owned by companies with word "meta" in their names.

How do you perform a search using "owner" parameter on whois data in reverse API?

With the owner parameter, you can search for domain whois data based on the name of the domain owner that will be publicly available in records. Enter the owner's name, and the API will provide a list of domains linked to that owner using search based query. For example, if you enter "michael", the API will search that name in full name of the owner.

Can I perform a search on whois records based on email address in reverse API?

Yes, you can search for whois information using an email address. The email parameter allows you to retrieve domains associated with a specific email address. Please note that this search is limited to publicly available email addresses. The search is precise, so make sure to input the complete and exact email.

What are the length limitations for the keyword parameter in reverse whois API queries?

When using the keyword parameter in reverse whois API queries, the keyword should be a minimum of 3 letters and a maximum of 63 letters.

Is the search case-insensitive?

Yes, all searches conducted through the reverse whois api are case-insensitive. This ensures that your queries are not affected by the letter case of your input.

Can I combine multiple parameters in a single request in reverse whois api?

Currently, the reverse whois api supports using only one parameter per query. If you want to perform a more specific query, you can refine your query by using the appropriate parameter that best matches your criteria.

Why are certain keywords restricted, and how can I access data associated with them?

Certain keywords that involve extensive hundred of millions of data are restricted to maintain the quality of our services. If you require information related to these keywords, please contact us at our support. We will assist you in accessing the restricted data through a customized solution that may charge custom price depending on the data.

Do you offer pagination for the reverse whois API, and how many records are provided per page?

Yes, we offer pagination for the reverse whois API. Currently, we provide two modes for the reverse whois api: the default mode and the mini mode. In the default mode, we provide 50 records per page, allowing you to retrieve a comprehensive list of domain whois data. In the mini mode, we offer 100 records per page, which is ideal for users who prefer a more concise display of data. We provide only domain name, creation date, expiry date, update date , owner's name, company and email in mini mode.

What is meant by Live Lookup endpoint and how much data latency does it offer?

Our Live Lookup API offers real-time access to various endpoints, including domain whois, SSL and DNS data. By directly connecting to authoritative sources, this API ensures that you receive the most current and up-to-date information, eliminating data latency.

What type of data do you provide in Historical API endpoint and how often is it updated?

Our Historical API offers a blend of up-to-date information and comprehensive unique historical data. We will provide all previous unique records related to that domain along with the latest data. Please note that we update our database on monthly basis, so the maximum data latency in our historical api data can be 1 month.

What is an IP WHOIS Lookup?

An IP WHOIS lookup is a query to retrieve information about an IP address, including the organization that registered it, contact information, and allocation details. The Live IP-Whois API provides responses in JSON/XML formats.

What information does an IP WHOIS Lookup provide?

It typically provides details like the registrant's name, organization, contact information, IP range, network name, and allocation status and also the details about the organization responsible for the given IP address.

Is IP WHOIS Lookup data always accurate?

WHOIS data relies on registrants providing accurate information. While registries strive for accuracy, there can be outdated or incomplete records.

Can I use IP WHOIS Lookup for any IP address?

Yes, you can look up the WHOIS information for any public IP address. Private IP addresses (e.g., 192.168.x.x) won't have WHOIS data as they are not globally unique.

What is an ASN WHOIS Lookup?

ASN WHOIS Lookup is a process to obtain information about an Autonomous System Number (ASN), which includes details about the organization that holds the ASN, routing policies, and more.

What kind of information does an ASN WHOIS Lookup reveal?

It reveals the ASN's registration details, the organization managing it, routing policies, status, and contact information for administrative and technical issues.

Why is ASN WHOIS Lookup important?

It's important for understanding the management of internet routing, identifying the operators of large networks, and for network troubleshooting or research purposes.

How often is ASN WHOIS data updated?

This depends on the policies of the regional internet registry maintaining the data. It's generally updated whenever there are significant changes to the ASN or its associated organization.

What is the number of free API credits available for new users, and are these credits rate-limited?

We will provide 500 API credits to new users and yes, those credits have a rate-limiting of 10 requests per minute for Live APIs, 5 requests per minute for Bulk Domain Lookup, and 1 request per minute for Reverse/Historical Endpoints.

Which TLDs are supported by your system?

You can check the current supported TLDs list.

Do you have notification service when API credits are near to an end?

Yes, we will inform you via an email. We send notification email on 80%,90%,100% usage. You can get credits/ subscription usage information from our billing portal or through API.

What happened if API credits have been utilized and my system is using whois API?

We provide surcharge requests on all active API credits subscriptions. You can fetch credits and surcharge requests information through our API. Each subscription plan has different surcharge requests limit.

Do you charge credit on 4xx error status codes in response?

No, We do not charge credits on 4xx status codes in response. All Whois APIs follow same rule for 4xx status codes in response.

Do you have rate limiting on number of requests being made on your paid plans?

Yes, we have rate limiting on requests being made on all of our paid plans. The requests limit is shown in the following table.

The Table is divided into three types of plans:

1) API Credits

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35

2) API Subscription

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35
  • Live-rpm: API requests per minute limit for live Whois lookup API, domain availability API, SSL certificate lookup API, and DNS lookup API endpoints.
  • Bulk-rpm: API requests per minute limit for bulk domain Whois lookup API endpoint.
  • Historical/Reverse-rpm: API requests per minute limit for historical, and reverse Whois API endpoints.

In case, the request per minute exceeds, it'll throw an error with HTTP error code of 429.

Do you provide any headers in API response regarding rate limiting?

Yes, there are following three header parameters in the response:

  • X-RateLimit-Allowed-Requests: Tells the max allowed API requests per minute on a specific plan.
  • X-RateLimit-Remaining-Requests: Tells the remaining API requests per minute for that plan.
  • X-RateLimit-Remaining-Time: Tells after how much time the API requests per minute will be reset.