Calling API

For getting the API key, you need to get started with our developer account. When you sign up then you can copy api key from our billing dashboard. We are providing 100 free API.

Copied
GET https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&keyword=youtube
GET https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&email=abc@gmail.com
GET https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&owner=michal
GET https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&company=youtube
GET https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&company=youtube&mode=mini
GET https://api.whoisfreaks.com/v1.0/whois?apiKey=API_KEY&whois=reverse&company=youtube&mode=mini&page=2


Input parameters: required

apiKey Get your API key on our billing dashboard.

whois For getting live or historical or reverse whois.

keyword The domain keyword for requested whois.
or
email The email for requested whois.
or
owner The owner Name for requested whois.
or
company The company Name for requested whois.


Input parameters: optional

mode Two modes are available mini,default

page For getting next or desired page whois info

format Two formats are available JSON, XML. If you don't pass format parameter, default format is JSON


Response

For getting the API key, you need to get started with our developer account. When you sign up then you can copy the API key from our billing dashboard. We are providing 100 free API calls.

        

default mode response(You can get upto 50 whois record per page)

{ "total_Result": 323, "total_Pages": 7, "current_Page": 1, "whois_domains_historical": [ { "num": 1, "status": true, "domain_name": "youtube.ovh", "query_time": "2020-04-06 15:16:34", "create_date": "2016-08-01", "expiry_date": "2020-08-01", "domain_registrar": { "registrar_name": "OVH", "website_url": "http://www.ovh.com" }, "registrant_contact": { "name": "REDACTED FOR PRIVACY", "city": "REDACTED FOR PRIVACY", "zip_code": "REDACTED FOR PRIVACY", "country_name": "France", "country_code": "FR", "email_address": "Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.", "phone": "REDACTED FOR PRIVACY", "fax": "REDACTED FOR PRIVACY" }, "administrative_contact": { "name": "REDACTED FOR PRIVACY", "company": "REDACTED FOR PRIVACY", "city": "REDACTED FOR PRIVACY", "state": "REDACTED FOR PRIVACY", "zip_code": "REDACTED FOR PRIVACY", "country_name": "REDACTED FOR PRIVACY", "country_code": "REDACTED FOR PRIVACY", "email_address": "Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.", "phone": "REDACTED FOR PRIVACY", "fax": "REDACTED FOR PRIVACY" }, "technical_contact": { "name": "REDACTED FOR PRIVACY", "company": "REDACTED FOR PRIVACY", "city": "REDACTED FOR PRIVACY", "state": "REDACTED FOR PRIVACY", "zip_code": "REDACTED FOR PRIVACY", "country_name": "REDACTED FOR PRIVACY", "country_code": "REDACTED FOR PRIVACY", "email_address": "Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.", "phone": "REDACTED FOR PRIVACY", "fax": "REDACTED FOR PRIVACY" }, "billing_contact": {}, "name_servers": [ "dave.ns.cloudflare.com", "vera.ns.cloudflare.com" ], "domain_status": [ "clientDeleteProhibited", "clientTransferProhibited" ] }, { "num": 2, "status": true, "domain_name": "youtube.ovh", "create_date": "2016-08-01", "expiry_date": "2017-08-01", "domain_registrar": { "registrar_name": "OVH" }, "registrant_contact": { "name": "chebiri mohamed", "city": "Roubaix Cedex 1", "zip_code": "59053", "country_name": "FRANCE", "email_address": "s04z2azkjpbmg75jsjli@z.o-w-o.info", "phone": "33972101007", "mailing_address": "youtube.ovh, office #9657345|c/o Owo, Bp80157" } }, { "num": 3, "status": true, "domain_name": "youtube.ovh", "create_date": "2015-06-05", "expiry_date": "2016-06-05", "domain_registrar": { "registrar_name": "OVH" }, "registrant_contact": { "name": "Harry Spink", "company": "Sandbox Media", "city": "Bristol", "zip_code": "BS3 1TF", "country_name": "UNITED KINGDOM", "email_address": "2oc70dbb602lmt04jyzy@z.o-w-o.info", "phone": "4.41179E+11", "mailing_address": "Tobacco Factory,|Bristol" } }, . . . . { "num": 50, "status": true, "domain_name": "youtube.capetown", "query_time": "2020-04-01 20:26:50", "create_date": "2014-09-30", "expiry_date": "2020-09-30", "domain_registrar": { "registrar_name": "MarkMonitor", "website_url": "markmonitor.com" }, "registrant_contact": { "name": "REDACTED", "city": "REDACTED", "state": "CA", "zip_code": "REDACTED", "country_name": "United States", "country_code": "US", "email_address": "Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.", "phone": "REDACTED", "fax": "REDACTED" }, "administrative_contact": { "name": "REDACTED", "company": "REDACTED", "city": "REDACTED", "state": "REDACTED", "zip_code": "REDACTED", "country_name": "REDACTED", "country_code": "REDACTED", "email_address": "Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.", "phone": "REDACTED", "fax": "REDACTED" }, "technical_contact": { "name": "REDACTED", "company": "REDACTED", "city": "REDACTED", "state": "REDACTED", "zip_code": "REDACTED", "country_name": "REDACTED", "country_code": "REDACTED", "email_address": "Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.", "phone": "REDACTED", "fax": "REDACTED" }, "billing_contact": { "name": "REDACTED", "company": "REDACTED", "city": "REDACTED", "state": "REDACTED", "zip_code": "REDACTED", "country_name": "REDACTED", "country_code": "REDACTED", "email_address": "Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.", "phone": "REDACTED", "fax": "REDACTED" }, "name_servers": [ "ns1.google.com", "ns2.google.com", "ns3.google.com", "ns4.google.com" ], "domain_status": [ "clientDeleteProhibited", "clientTransferProhibited", "clientUpdateProhibited" ] }


        

Mini mode response(You can get upto 100 whois record per page)

{ "total_Result": 323, "total_Pages": 4, "current_Page": 1, "whois_domains_historical": [ { "num": 1, "domain_name": "youtube.ovh", "create_date": "2016-08-01", "expiry_date": "2020-08-01", "name": "redacted for privacy", "email": "please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.", "company_name": "" }, { "num": 2, "domain_name": "youtube.ovh", "create_date": "2016-08-01", "expiry_date": "2017-08-01", "name": "redacted for privacy", "email": "please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.", "company_name": "" }, { "num": 3, "domain_name": "youtube.ovh", "create_date": "2015-06-05", "expiry_date": "2016-06-05", "name": "redacted for privacy", "email": "please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.", "company_name": "" }, . . . . { "num": 100, "domain_name": "youtube.la", "create_date": "2014-08-03", "expiry_date": "2020-08-03", "name": "", "email": "https://whois.nic.la/contact/youtube.la/registrant", "company_name": "" }

                
                    

default mode response(You can get upto 50 whois record per page)

<ReverseWhoisResponse> <total_Result>323</total_Result> <total_Pages>7</total_Pages> <current_Page>1</current_Page> <whois_domains_historical> <whois_domains_historical> <num>1</num> <status>true</status> <domain_name>youtube.ovh</domain_name> <query_time>2020-04-06 15:16:34</query_time> <create_date>2016-08-01</create_date> <expiry_date>2020-08-01</expiry_date> <domain_registrar> <registrar_name>OVH</registrar_name> <website_url>http://www.ovh.com</website_url> </domain_registrar> <registrant_contact> <name>REDACTED FOR PRIVACY</name> <city>REDACTED FOR PRIVACY</city> <zip_code>REDACTED FOR PRIVACY</zip_code> <country_name>France</country_name> <country_code>FR</country_code> <email_address>Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.</email_address> <phone>REDACTED FOR PRIVACY</phone> <fax>REDACTED FOR PRIVACY</fax> </registrant_contact> <administrative_contact> <name>REDACTED FOR PRIVACY</name> <company>REDACTED FOR PRIVACY</company> <city>REDACTED FOR PRIVACY</city> <state>REDACTED FOR PRIVACY</state> <zip_code>REDACTED FOR PRIVACY</zip_code> <country_name>REDACTED FOR PRIVACY</country_name> <country_code>REDACTED FOR PRIVACY</country_code> <email_address>Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.</email_address> <phone>REDACTED FOR PRIVACY</phone> <fax>REDACTED FOR PRIVACY</fax> </administrative_contact> <technical_contact> <name>REDACTED FOR PRIVACY</name> <company>REDACTED FOR PRIVACY</company> <city>REDACTED FOR PRIVACY</city> <state>REDACTED FOR PRIVACY</state> <zip_code>REDACTED FOR PRIVACY</zip_code> <country_name>REDACTED FOR PRIVACY</country_name> <country_code>REDACTED FOR PRIVACY</country_code> <email_address>Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin, or Tech contact of the queried domain name.</email_address> <phone>REDACTED FOR PRIVACY</phone> <fax>REDACTED FOR PRIVACY</fax> </technical_contact> <billing_contact/> <name_servers> <name_servers>dave.ns.cloudflare.com</name_servers> <name_servers>vera.ns.cloudflare.com</name_servers> </name_servers> <domain_status> <domain_status>clientDeleteProhibited</domain_status> <domain_status>clientTransferProhibited</domain_status> </domain_status> </whois_domains_historical> <whois_domains_historical> <num>2</num> <status>true</status> <domain_name>youtube.ovh</domain_name> <create_date>2016-08-01</create_date> <expiry_date>2017-08-01</expiry_date> <domain_registrar> <registrar_name>OVH</registrar_name> </domain_registrar> <registrant_contact> <name>chebiri mohamed</name> <city>Roubaix Cedex 1</city> <zip_code>59053</zip_code> <country_name>FRANCE</country_name> <email_address>s04z2azkjpbmg75jsjli@z.o-w-o.info</email_address> <phone>33972101007</phone> <mailing_address>youtube.ovh, office #9657345|c/o Owo, Bp80157</mailing_address> </registrant_contact> </whois_domains_historical> <whois_domains_historical> <num>3</num> <status>true</status> <domain_name>youtube.ovh</domain_name> <create_date>2015-06-05</create_date> <expiry_date>2016-06-05</expiry_date> <domain_registrar> <registrar_name>OVH</registrar_name> </domain_registrar> <registrant_contact> <name>Harry Spink</name> <company>Sandbox Media</company> <city>Bristol</city> <zip_code>BS3 1TF</zip_code> <country_name>UNITED KINGDOM</country_name> <email_address>2oc70dbb602lmt04jyzy@z.o-w-o.info</email_address> <phone>4.41179E+11</phone> <mailing_address>Tobacco Factory,|Bristol</mailing_address> </registrant_contact> </whois_domains_historical> . . . . <whois_domains_historical> <num>50</num> <status>true</status> <domain_name>youtube.capetown</domain_name> <query_time>2020-04-01 20:26:50</query_time> <create_date>2014-09-30</create_date> <expiry_date>2020-09-30</expiry_date> <domain_registrar> <registrar_name>MarkMonitor</registrar_name> <website_url>markmonitor.com</website_url> </domain_registrar> <registrant_contact> <name>REDACTED</name> <city>REDACTED</city> <state>CA</state> <zip_code>REDACTED</zip_code> <country_name>United States</country_name> <country_code>US</country_code> <email_address>Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.</email_address> <phone>REDACTED</phone> <fax>REDACTED</fax> </registrant_contact> <administrative_contact> <name>REDACTED</name> <company>REDACTED</company> <city>REDACTED</city> <state>REDACTED</state> <zip_code>REDACTED</zip_code> <country_name>REDACTED</country_name> <country_code>REDACTED</country_code> <email_address>Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.</email_address> <phone>REDACTED</phone> <fax>REDACTED</fax> </administrative_contact> <technical_contact> <name>REDACTED</name> <company>REDACTED</company> <city>REDACTED</city> <state>REDACTED</state> <zip_code>REDACTED</zip_code> <country_name>REDACTED</country_name> <country_code>REDACTED</country_code> <email_address>Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.</email_address> <phone>REDACTED</phone> <fax>REDACTED</fax> </technical_contact> <billing_contact> <name>REDACTED</name> <company>REDACTED</company> <city>REDACTED</city> <state>REDACTED</state> <zip_code>REDACTED</zip_code> <country_name>REDACTED</country_name> <country_code>REDACTED</country_code> <email_address>Please query the RDDS service of the Registrar of Record identified in this output for information on how to contact the Registrant, Admin or Tech contacts of the domain name.</email_address> <phone>REDACTED</phone> <fax>REDACTED</fax> </billing_contact> <name_servers> <name_servers>ns1.google.com</name_servers> <name_servers>ns2.google.com</name_servers> <name_servers>ns3.google.com</name_servers> <name_servers>ns4.google.com</name_servers> </name_servers> <domain_status> <domain_status>clientDeleteProhibited</domain_status> <domain_status>clientTransferProhibited</domain_status> <domain_status>clientUpdateProhibited</domain_status> </domain_status> </whois_domains_historical> </whois_domains_historical> </ReverseWhoisResponse>

                
                    

default mode response(You can get upto 100 whois record per page)

<ReverseWhoisMiniResponse> <total_Result>323</total_Result> <total_Pages>4</total_Pages> <current_Page>1</current_Page> <whois_domains_historical> <whois_domains_historical> <num>1</num> <domain_name>youtube.ovh</domain_name> <create_date>2016-08-01</create_date> <expiry_date>2020-08-01</expiry_date> <name>redacted for privacy</name> <email>please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.</email> <company_name></company_name> </whois_domains_historical> <whois_domains_historical> <num>2</num> <domain_name>youtube.ovh</domain_name> <create_date>2016-08-01</create_date> <expiry_date>2017-08-01</expiry_date> <name>redacted for privacy</name> <email>please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.</email> <company_name></company_name> </whois_domains_historical> <whois_domains_historical> <num>3</num> <domain_name>youtube.ovh</domain_name> <create_date>2015-06-05</create_date> <expiry_date>2016-06-05</expiry_date> <name>redacted for privacy</name> <email>please query the rdds service of the registrar of record identified in this output for information on how to contact the registrant, admin, or tech contact of the queried domain name.</email> <company_name></company_name> </whois_domains_historical> . . . . <whois_domains_historical> <num>100</num> <domain_name>youtube.la</domain_name> <create_date>2014-08-03</create_date> <expiry_date>2020-08-03</expiry_date> <name></name> <email>https://whois.nic.la/contact/youtube.la/registrant</email> <company_name></company_name> </whois_domains_historical> </whois_domains_historical> </ReverseWhoisMiniResponse>



Important Note:

This is the complete json with domain_registrar,registrant_contact,administrative_contact,technical_contact,billing_contact,name_servers, domain_status objects.In some cases some of these objects can be empty when performing whois of requested domains because whois have missing information of such object so you should must have to check condition on your side.

HTTP Error Codes

Below mentioned possible type of error and desc

            
{
    "timestamp": 1614257515905,
    "status": 404,
    "error": "Record Not Found",
    "message": "Record not found",
    "path": "/v1.0/whois/whois=reverse&keyword=KEYWORD&apiKey=API_KEY"
}
            
            
            
{
    "timestamp": 1614257592018,
    "status": 400,
    "error": "Invalid Param Exception",
    "message": "Please pass  param value",
    "path": "/v1.0/whois/whois=reverse&keyword=&format=json&mode=mini&apiKey=API_KEY"
}


            
 

Some common Errors:

                        
 {
    "timestamp": 1612161378521,
    "status": 401,
    "error": "Api Access Exception",
    "message": "Provided API key is invalid. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            
                        

                        
 {
    "timestamp": 1612161378521,
    "status": 401,
    "error": "Api Access Exception",
    "message": "Provided API key is inactive. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            
                        

                        
 {
    "timestamp": 1612161378521,
    "status": 401,
    "error": "Api Access Exception",
    "message": "Please buy subscription plan or add api credits then use this api key. [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            
                        

                        
 {
    "timestamp": 1612161378521,
    "status": 413,
    "error": "Api Access Exception",
    "message": "You have exceeded the limit of api credits requests [allowed_request_no].Please upgrade your plan [For Technical Support: support@whoisfreaks.com]  ",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            
                        

                        
 {
    "timestamp": 1612161378521,
    "status": 412,
    "error": "Api Access Exception",
    "message": "You have exceeded the limit of api plan requests and your subscription canceled.Please contact our technical support team: support@whoisfreaks.com]",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            

            

                        
 {
    "timestamp": 1612161378521,
    "status": 413,
    "error": "Api Access Exception",
    "message": "You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan [For Technical Support: support@whoisfreaks.com] ",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            

            

                        
 {
    "timestamp": 1612161378521,
    "status": 401,
    "error": "Api Access Exception",
    "message": "Your subscription is deactivated.Please buy new plan or add api credits for using whoisfreaks api's [For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            
                        

                        
 {
    "timestamp": 1612161378521,
    "status": 401,
    "error": "Api Access Exception",
    "message": "Your subscription is deactivated due to many time payment failure.Please buy new plan or add api credits for using whoisfreaks api's",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            
                        



                        
 {
    "timestamp": 1612161378521,
    "status": 401,
    "error": "Api Access Exception",
    "message": "Your account is deactivated.[For Technical Support: support@whoisfreaks.com]",
    "path": "/v1.0/whois/whois=live&domainName=DOMAIN_NAME&apiKey=API_KEY"
}
            
                        
            
<ApiExceptionResponse>
    <timestamp>1614257672825</timestamp>
    <status>400</status>
    <error>Invalid Param Exception</error>
    <message>Please pass  param value</message>
    <path>/v1.0/whois/whois=reverse&keyword=&format=XML&apiKey=API_KEY</path>
</ApiExceptionResponse>
            
        
                
<ApiExceptionResponse>
    <timestamp>1614257699538</timestamp>
    <status>404</status>
    <error>Record Not Found</error>
    <message>Record not found</message>
    <path>/v1.0/whois/whois=reverse&keyword=KEYWORD&format=XML&apiKey=API_KEY</path>
</ApiExceptionResponse>
                
            

Some common Errors:



<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>401</status>
    <error>Api Access Exception</error>
    <message>Provided API key is invalid. [For Technical Support: support@whoisfreaks.com]</message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>401</status>
    <error>Api Access Exception</error>
    <message>Provided API key is inactive. [For Technical Support: support@whoisfreaks.com]</message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>401</status>
    <error>Api Access Exception</error>
    <message>Please buy subscription plan or add api credits then use this api key. [For Technical Support: support@whoisfreaks.com]</message>
    <path>/v1.0/whois/whois=live&domainName=domainName=DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>413</status>
    <error>Api Access Exception</error>
    <message>You have exceeded the limit of api credits requests [allowed_request_no].Please upgrade your plan [For Technical Support: support@domainName=DOMAIN_NAME]</message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>412</status>
    <error>Api Access Exception</error>
    <message>You have exceeded the limit of api plan requests and your subscription canceled.Please contact our technical support team: support@whoisfreaks.com]</message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>413</status>
    <error>Api Access Exception</error>
    <message>You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan [For Technical Support: support@whoisfreaks.com] </message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>401</status>
    <error>Api Access Exception</error>
    <message>Your subscription is deactivated.Please buy new plan or add api credits for using whoisfreaks api's [For Technical Support: support@whoisfreaks.com]</message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>401</status>
    <error>Api Access Exception</error>
    <message>Your subscription is deactivated due to many time payment failure.Please buy new plan or add api credits for using whoisfreaks api's</message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>




<ApiExceptionResponse>
    <timestamp>1614238550354</timestamp>
    <status>401</status>
    <error>Api Access Exception</error>
    <message>Your account is deactivated.[For Technical Support: support@whoisfreaks.com]</message>
    <path>/v1.0/whois/whois=live&DOMAIN_NAME&apiKey=API_KEY</path>
</ApiExceptionResponse>

API Usage Rule

Cost Using Reverse Whois Service charge will be 4 credits per domain for 1 page.For next page we will charge 1 credit

Code Snippet


    curl --location --request GET 'https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016'



var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016',
  'headers': {
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});





    OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();




    import http.client
    conn = http.client.HTTPSConnection("api.whoisfreaks.com")
payload = ''
headers = {}
conn.request("GET", "/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))




     'https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;





require "uri"
require "net/http"

url = URI("https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body





    var requestOptions = {
  method: 'GET',
  redirect: 'follow'
};

fetch("https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));




var client = new RestClient("https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);




    package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}




    CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
  curl_easy_setopt(curl, CURLOPT_URL, "https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016");
  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
  struct curl_slist *headers = NULL;
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);





import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif

var semaphore = DispatchSemaphore (value: 0)

var request = URLRequest(url: URL(string: "https://api.whoisfreaks.com/v1.0/whois?whois=reverse&company=youtube&apikey=6363653972fe4df89638c45db1acf016")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    semaphore.signal()
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}

task.resume()
semaphore.wait()




FAQs



Not Found Reverse Whois Record of domains will be charged or not?

No! You will not be charged if our system does not provide Reverse Whois record.



How old you have Reverse Historical record?

We are Providing historical whois data from 1986



How many TLDs are supported by your system?

you can check here current supported TLD's list



Do you have notification service when my API credits or requests near to an end?

Yes, we will inform you via an email. We send notification email on 80%,90%,100% usage.



What happened if my API credits or requests are ended and my system is using whois API?

On Subscription plans we have surcharge service. We will serve you if your API credits or requests limit reached until your surcharge allowed request limit reach. Each subscription plan has a different no of surcharge requests.



What is surcharge service?

Whenever your system will consume your API subscription plan quota 100% then we take care and keep on serving you according to your plan surcharge requests. And when your subscription will renew then our system will calculate amount according to surcharge requests consumed and add this amount to the actual plan price.



API Credit plans have surcharge service?

No. We don't server when API credit plans have reached their requests limit.