Logo
Logo

PRODUCTS

TOOLS

Access Complete Domain Ownership Data withOur WHOIS Lookup API

We provides Whois Lookup, Whois History, Reverse Whois Search and Bulk Whois Lookup APIs for any domain(s).

1[
2  {
3    "status": true,
4    "domain_name": "whoisfreaks.com",
5    "query_time": "2024-07-11 13:03:30",
6    "whois_server": "whois.verisign-grs.com",
7    "domain_registered": "yes",
8    "create_date": "2019-03-19",
9    "update_date": "2024-02-18",
10    "expiry_date": "2025-03-19",
11    "domain_registrar": {
12      "iana_id": "1068",
13      "registrar_name": "NAMECHEAP INC",
14      "whois_server": "whois.namecheap.com",
15      "website_url": "http://www.namecheap.com",
16      "email_address": "abuse@namecheap.com",
17      "phone_number": "+1.9854014545"
18    },
19    "reseller_contact": {
20      "name": "NAMECHEAP INC",
21      "email_address": "N/A",
22      "phone": "N/A"
23    },
24    "registrant_contact": {
25      "name": "Redacted for Privacy",
26      "company": "Privacy service provided by Withheld for Privacy ehf",
27      "street": "Kalkofnsvegur 2",
28      "city": "Reykjavik",
29      "state": "Capital Region",
30      "zip_code": "101",
31      "country_name": "Iceland",
32      "country_code": "IS",
33      "email_address": "b8e54d7b11b347b285b60992e0889dde.protect@withheldforprivacy.com",
34      "phone": "+354.4212434",
35      "fax": "N/A",
36      "mailing_address": "Kalkofnsvegur 2, 101 Reykjavik, Capital Region, Iceland"
37    },
38    "administrative_contact": {
39      "name": "Redacted for Privacy",
40      "company": "Privacy service provided by Withheld for Privacy ehf",
41      "street": "Kalkofnsvegur 2",
42      "city": "Reykjavik",
43      "state": "Capital Region",
44      "zip_code": "101",
45      "country_name": "Iceland",
46      "country_code": "IS",
47      "email_address": "b8e54d7b11b347b285b60992e0889dde.protect@withheldforprivacy.com",
48      "phone": "+354.4212434",
49      "fax": "N/A",
50      "mailing_address": "Kalkofnsvegur 2, 101 Reykjavik, Capital Region, Iceland"
51    },
52    "technical_contact": {
53      "name": "Redacted for Privacy",
54      "company": "Privacy service provided by Withheld for Privacy ehf",
55      "street": "Kalkofnsvegur 2",
56      "city": "Reykjavik",
57      "state": "Capital Region",
58      "zip_code": "101",
59      "country_name": "Iceland",
60      "country_code": "IS",
61      "email_address": "b8e54d7b11b347b285b60992e0889dde.protect@withheldforprivacy.com",
62      "phone": "+354.4212434",
63      "fax": "N/A",
64      "mailing_address": "Kalkofnsvegur 2, 101 Reykjavik, Capital Region, Iceland"
65    },
66    "billing_contact": {
67      "name": "N/A",
68      "company": "N/A",
69      "street": "N/A",
70      "city": "N/A",
71      "state": "N/A",
72      "zip_code": "N/A",
73      "country_name": "N/A",
74      "country_code": "N/A",
75      "email_address": "N/A",
76      "phone": "N/A",
77      "fax": "N/A",
78      "mailing_address": "N/A"
79    },
80    "name_servers": [
81      "dns3.cloudns.net",
82      "dns4.cloudns.net",
83      "dns7.cloudns.net",
84      "dns8.cloudns.net"
85    ],
86    "domain_status": [
87      "clientTransferProhibited"
88    ],
89    "whois_raw_domain": " Domain name: whoisfreaks.com Registry Domain ID: 2370976244_DOMAIN_COM-VRSN Registrar WHOIS Server: whois.namecheap.com Registrar URL: http://www.namecheap.com Updated Date: 2024-02-18T08:28:27.96Z Creation Date: 2019-03-19T18:24:27.00Z Registrar Registration Expiration Date: 2025-03-19T18:24:27.00Z Registrar: NAMECHEAP INC Registrar IANA ID: 1068 Registrar Abuse Contact Email: abuse@namecheap.com Registrar Abuse Contact Phone: +1.9854014545 Reseller: NAMECHEAP INC Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited Registry Registrant ID:  Registrant Name: Redacted for Privacy Registrant Organization: Privacy service provided by Withheld for Privacy ehf Registrant Street: Kalkofnsvegur 2  Registrant City: Reykjavik Registrant State/Province: Capital Region Registrant Postal Code: 101 Registrant Country: IS Registrant Phone: +354.4212434 Registrant Phone Ext:  Registrant Fax:  Registrant Fax Ext:  Registrant Email: b8e54d7b11b347b285b60992e0889dde.protect@withheldforprivacy.com Registry Admin ID:  Admin Name: Redacted for Privacy Admin Organization: Privacy service provided by Withheld for Privacy ehf Admin Street: Kalkofnsvegur 2  Admin City: Reykjavik Admin State/Province: Capital Region Admin Postal Code: 101 Admin Country: IS Admin Phone: +354.4212434 Admin Phone Ext:  Admin Fax:  Admin Fax Ext:  Admin Email: b8e54d7b11b347b285b60992e0889dde.protect@withheldforprivacy.com Registry Tech ID:  Tech Name: Redacted for Privacy Tech Organization: Privacy service provided by Withheld for Privacy ehf Tech Street: Kalkofnsvegur 2  Tech City: Reykjavik Tech State/Province: Capital Region Tech Postal Code: 101 Tech Country: IS Tech Phone: +354.4212434 Tech Phone Ext:  Tech Fax:  Tech Fax Ext:  Tech Email: b8e54d7b11b347b285b60992e0889dde.protect@withheldforprivacy.com Name Server: dns3.cloudns.net Name Server: dns4.cloudns.net Name Server: dns7.cloudns.net Name Server: dns8.cloudns.net DNSSEC: unsigned URL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net/ >>> Last update of WHOIS database: 2024-07-11T08:03:30.50Z <<< For more information on Whois status codes, please visit https://icann.org/epp",
90    "registry_data": {
91      "domain_name": "WHOISFREAKS.COM",
92      "query_time": "2024-07-11 13:03:30",
93      "whois_server": "whois.verisign-grs.com",
94      "domain_registered": "yes",
95      "create_date": "N/A",
96      "update_date": "N/A",
97      "expiry_date": "N/A",
98      "domain_registrar": {
99        "iana_id": "1068",
100        "registrar_name": "NameCheap, Inc.",
101        "whois_server": "whois.namecheap.com",
102        "website_url": "http://www.namecheap.com",
103        "email_address": "abuse@namecheap.com",
104        "phone_number": "+1.6613102107"
105      },
106      "name_servers": [
107        "dns3.cloudns.net",
108        "dns4.cloudns.net",
109        "dns7.cloudns.net",
110        "dns8.cloudns.net"
111      ],
112      "domain_status": [
113        "clientTransferProhibited"
114      ],
115      "whois_raw_registry": "    Domain Name: WHOISFREAKS.COM    Registry Domain ID: 2370976244_DOMAIN_COM-VRSN    Registrar WHOIS Server: whois.namecheap.com    Registrar URL: http://www.namecheap.com    Updated Date: 2024-02-18T08:28:27Z    Creation Date: 2019-03-19T18:24:27Z    Registry Expiry Date: 2025-03-19T18:24:27Z    Registrar: NameCheap, Inc.    Registrar IANA ID: 1068    Registrar Abuse Contact Email: abuse@namecheap.com    Registrar Abuse Contact Phone: +1.6613102107    Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited    Name Server: DNS3.CLOUDNS.NET    Name Server: DNS4.CLOUDNS.NET    Name Server: DNS7.CLOUDNS.NET    Name Server: DNS8.CLOUDNS.NET    DNSSEC: unsigned    URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/ >>> Last update of whois database: 2024-07-11T13:03:13Z <<<  For more information on Whois status codes, please visit https://icann.org/epp  NOTICE: The expiration date displayed in this record is the date the registrar's sponsorship of the domain name registration in the registry is currently set to expire. This date does not necessarily reflect the expiration date of the domain name registrant's agreement with the sponsoring registrar.  Users may consult the sponsoring registrar's Whois database to view the registrar's reported date of expiration for this registration.  TERMS OF USE: You are not authorized to access or query our Whois database through the use of electronic processes that are high-volume and automated except as reasonably necessary to register domain names or modify existing registrations; the Data in VeriSign Global Registry Services' (\"VeriSign\") Whois database is provided by VeriSign for information purposes only, and to assist persons in obtaining information about or related to a domain name registration record. VeriSign does not guarantee its accuracy. By submitting a Whois query, you agree to abide by the following terms of use: You agree that you may use this Data only for lawful purposes and that under no circumstances will you use this Data to: (1) allow, enable, or otherwise support the transmission of mass unsolicited, commercial advertising or solicitations via e-mail, telephone, or facsimile; or (2) enable high volume, automated, electronic processes that apply to VeriSign (or its computer systems). The compilation, repackaging, dissemination or other use of this Data is expressly prohibited without the prior written consent of VeriSign. You agree not to use electronic processes that are automated and high-volume to access or query the Whois database except as reasonably necessary to register domain names or modify existing registrations. VeriSign reserves the right to restrict your access to the Whois database in its sole discretion to ensure operational stability.  VeriSign may restrict or terminate your access to the Whois database for failure to abide by these terms of use. VeriSign reserves the right to modify these terms at any time.  The Registry database contains ONLY .COM, .NET, .EDU domains and Registrars."
116    }
117  }
118]
google.com
apple.com
stripe.com
apifreaks.com
pricing backgroundEclipse Top RightEclipse Top LeftEclipse WHOIS Stats
1528+
TLDs
690M+
Active Domains
877M+
Domains Tracked
3554M+
WHOIS Records
4931M+
Host Names
13B+
DNS Records

Our Products

WhoisAPIs
A comprehensive API platform for live WHOIS lookup, WHOIS history lookup, and reverse WHOIS search for any domain by registrant name or email, available in JSON and XML formats.
Live Whois API
Historical Whois Data
Reverse Whois API
Whois Lookup API

Live 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, available in both JSON and XML formats. Live WHOIS Lookup fetches data in real time from WHOIS servers and RDAP to ensure the freshest results on every request, with no database dependency.

Product

Bulk WhoisAPI
Enable you to retrieve deep domain intelligence instantly with a single query.
Bulk Whois Lookup API

The Bulk Whois Lookup API allows you to perform whois lookups for multiple domain names in a single query. Process 100 domains per request or upload files up to 3 million for live and historical WHOIS records, delivered as a CSV file via email.

monitoring

Features

WhatWhois APIsProvide

Seamlessly integrate valuable data and features into your platform.

Feature icon

Real Time Data

Fetch real-time, accurate domain data using live WHOIS lookup by domain, IP, or ASN. We fetch details directly from live servers.

Feature icon

Email Based Lookup

Email-based lookup in reverse whois search allows you to find all domains associated with a specific email address.

Feature icon

Domain's Past Info

Access historical domain whois records using historical whois lookup from our comprehensive database.

Feature icon

Company Based Lookup

Perform a reverse whois search to find domain ownership details linked to a specific company for threat mitigation.

Feature icon

Registrant Based Lookup

Use WHOIS Reverse Search Lookup with WHOIS email search to retrieve ownership details for domain analysis.

Feature icon

Domain Ownership Details

Who owns a domain is no longer a limitation. Use our Live or Bulk WHOIS API to retrieve the ownership and registrar details.

Feature icon

Keyword Based Lookup

Use WHOIS Reverse Search Lookup with WHOIS email search to retrieve ownership details for domain analysis.

Feature icon

Consistent & Compressed data

Consistent, compressed data ensures efficient retrieval and optimizes storage and bandwidth.

Product

OtherWhois APIs

Access real-time WHOIS data across IP addresses and ASNs.

ASN Whois Lookup API

The ASN Whois Lookup API delivers information on Autonomous System Numbers used in internet routing. This includes details about ASN ownership, network infrastructure, organization details, and the range of IP addresses associated with the ASN.

button
button

IP Whois Lookup API

The IP Whois Lookup API provides detailed information about IP addresses, including registration data, contact details, routes, and network information. This API helps in identifying the ownership and allocation of IP addresses, which can be useful for network administration, cybersecurity, geolocation services, and fraud prevention.

Product

WhoisDatabase
Acquire historical WHOIS data, power your custom systems, update every day.
Whois Database

Explore our extensive WHOIS database covering 1500+ TLDs and nearly 3.5B unique historical WHOIS records. We also offer country-specific datasets for markets like the US and UK covering both .us/.uk domains and domains registered by owners located in the US or UK. Refine your research with precision by filtering results by registrar, TLD, country, and more.

monitoring

Use Cases

WHOIS in Action

See how our users leverage WHOIS data to gain actionable insights.

Feature icon

Data Enrichment

WhoisFreaks delivers reliable, up‑to‑date domain and website data to power CRM, marketing, and audience insights.

Feature icon

Domain Registration and Portfolio Analysis

Bulk WHOIS Lookup helps manage your domain portfolio, with Live and Historical WHOIS API.

Feature icon

Threat Intelligence

Our Reverse WHOIS service, powered by Live and Historical WHOIS API, helps uncover hidden data, and enhance threat.

Feature icon

Brand Monitoring & Brand Protection

Protect and monitor your brand and intellectual property with our real-time WHOIS API and Bulk WHOIS Lookup.

Feature icon

Competitive Intelligence

Bulk WHOIS Lookup reveals competitor domains information helping analyze portfolios and marketing strategies.

Feature icon

Research & Due Dilligence

WHOIS History Lookup supports domain or business due diligence by revealing ownership, history, and expiry details.

Request demo background

Integrate our WHOIS APIs now to power your threat intelligence, access real-time and historical domain data, and make smarter security decisions.

pricing background

Documentation

Live Lookup

The WHOIS Domain API delivers structured JSON or XML data with registry and registrar details when available. It organizes ownership information into separate objects—registrant, technical, billing, and administrative—alongside nameservers and key domain dates such as registration and expiry. The WHOIS Domain API’s structured format ensures seamless integration into your systems.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    The value of whois will be 'live'.
  • domainName
    The domainName for requested whois.
Optional
  • 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...

Status Codes

Success Codes
  • 200Request is processed successfully.
  • 206Partial response, as an error occurred while processing the request.
  • 210Cached response, as the WHOIS server failed to respond.
Failure Codes
  • 400Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com, http://whoisfreaks.com
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 403We are not providing the whois of this domain extension (e.g., comsdf)
  • 403Provided domain belongs to an inactive TLD. Please try to use historical whois lookup.
  • 408Unable to fetch whois data. Please try again.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 500Internal Server error occurred.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.

Historical Lookup

The WHOIS History API provides historical WHOIS data for domains, with multiple records stored in separate JSON or XML objects using a consistent format. The WHOIS History Lookup also retrieves live WHOIS data, excluding it when the latest record matches the current one.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    The value of whois will be 'historical'.
  • domainName
    The domainName for requested whois.
Optional
  • 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...

Status Codes

Success Codes
  • 200Request is processed successfully.
Failure Codes
  • 400Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com, http://whoisfreaks.com
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 404Record not found.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 500Internal Server error occurred.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.

Reverse Lookup

The Reverse WHOIS API allows searches across WHOIS records by email (registrant, billing, administrative, technical contacts), owner, keyword, or company. It supports pattern matching when the exact parameter is set to false. For instance, to find a keyword containing ‘end’ after ‘whois’, you can use 'whois*end'. The * (asterisk) represents any number of characters, making searches more flexible and powerful.

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.

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 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...

Status Codes

Success Codes
  • 200Request is processed successfully.
Failure Codes
  • 400Please provide correct value Param
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 404Record not found.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 500Internal Server error occurred.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.

IP Lookup

The IP WHOIS API provides detailed IP address information, including registration data, organization details, administrative, technical, and abuse contacts, as well as routing and network information, all returned in well‑structured JSON or XML format.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • ip
    IPv4 or IPv6 address for the requested whois.
Optional
  • 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...

Status Codes

Success Codes
  • 200Request is processed successfully.
  • 206Partial response, as an error occurred while processing the request.
Failure Codes
  • 400Request-param 'ip' (<ip>) is not valid.
  • 400Request-param 'format' (<format>) is not valid. Supported formats are json, xml.
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 408Unable to fetch whois data. Please try again.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 500Internal Server error occurred.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.

ASN Lookup

The ASN WHOIS API provides detailed information about Autonomous System Numbers (ASNs), including the AS number, name, organization details, country, domain, allocation status, and associated IPv4 and IPv6 routes. It also returns upstream and downstream providers, peers, administrative and technical contacts, abuse contacts, and raw WHOIS data, all available in JSON or XML format.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • asn
    The ASN number with or without 'as' for requested whois. (e.g. as1009 or 1009)
Optional
  • 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...

Status Codes

Success Codes
  • 200Request is processed successfully.
  • 206Partial response, as an error occurred while processing the request.
Failure Codes
  • 400Request-param 'asn' (******) is not valid.
  • 400Request-param 'format' (<format>) is not valid. Supported formats are json, xml.
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 408Unable to fetch whois data. Please try again.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 500Internal Server error occurred.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.

Bulk Domain Lookup

The Bulk WHOIS API performs live WHOIS lookups for up to 100 domains at once by submitting domain names in the body parameter. The Bulk WHOIS API also supports file uploads with up to 3 million entries (one domain per line), with results sent directly to the user via email.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
Optional
  • 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...

Status Codes

Success Codes
  • 200Request is processed successfully.
  • 206Partial response, as an error occurred while processing the request.
  • 210Cached response, as the WHOIS server failed to respond.
Failure Codes
  • 400Please provide domainNames in request body.
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 403We are not providing the whois of this domain extension (e.g., comsdf)
  • 403Provided domain belongs to an inactive TLD. Please try to use historical whois lookup.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413The requested list size is [GREATER_THAN_100] which exceeds the maximum list size of 100.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 500Internal Server error occurred.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.
FAQs
Enhance your apps with industry leading web scraping and crawling.
How can I request WHOIS information for thousands of domains?
What is Whois API and how does it work?
Do you offer a free whois api?
How old do you have historical records?
Is each Whois Record in historical database unique?
What is the minimum number of domain names required for bulk whois?
Will you charge on failed domains in bulk whois search utility?
How do you perform a search using "company" parameter on whois data in reverse API?
How do you perform a search using "owner" parameter on whois data in reverse API?
What is the "exact" match parameter in reverse WHOIS?
Can I perform a search on whois records based on email address in reverse API?
How can I perform a regex-based search for email addresses in reverse WHOIS?
What are the length limitations for the keyword parameter in reverse whois API queries?
Is the search case-insensitive?
Can I combine multiple parameters in a single request in reverse whois api?
Why are certain keywords restricted, and how can I access data associated with them?
Do you offer pagination for the reverse whois API, and how many records are provided per page?
What is meant by Live Lookup endpoint and how much data latency does it offer?
What type of data do you provide in Historical API endpoint and how often is it updated?
What is an IP WHOIS Lookup?
What information does an IP WHOIS Lookup provide?
Is IP WHOIS Lookup data always accurate?
Can I use IP WHOIS Lookup for any IP address?
What is an ASN WHOIS Lookup?
What kind of information does an ASN WHOIS Lookup reveal?
Why is ASN WHOIS Lookup important?
How often is ASN WHOIS data updated?
What is the number of free API credits available for new users, and are these credits rate-limited?
Which TLDs are supported by your system?
Do you have notification service when API credits are near to an end?
What happened if API credits have been utilized and my system is using whois API?
Do you charge credit on 4xx error status codes in response?
Do you have rate limiting on number of requests being made on your paid plans?
Do you provide any headers in API response regarding rate limiting?