QuickGuide WhoisProxy

The WhoisProxy for TLDs offered by InterNetX enables users to check the availability of domains quickly.

Table of Contents for this Site

Introduction

The WhoisProxy for TLDs offered by InterNetX enables users to check the availability of domains quickly. Whois requests are carried out via the Linux console.

Activation

In order to use the WhoisProxy, we need to activate the service for the IP that will be used to access the WhoisProxy. As soon as it has been activated, you can use the WhoisProxy via the Linux console. If you would like to use this service, please contact Sales (sales@internetx.com) or our Domain Services (domain-support@internetx.com).

Adding, changing or removing IP addresses to the WhoisProxy

If you would like to add a new IP address to the WhoisProxy, please contact Sales (sales@internetx.com). To change an existing IP address that is used to connect to the WhoisProxy or to remove an existing IP address from the WhoisProxy please, contact Domain Services (domain-services@internetx.com).

Restrictions

We place restrictions on the number of permitted Whois requests. If you would like to extend this limit, please contact our sales team at sales@internetx.com. In addition, the registries also restrict requests - the number of permitted requests therefore varies greatly from registry to registry.

When placing your order, you can choose a percentual threshold value for the Whois requests and set an email address. As soon as this Whois threshold value has been reached or respectively exceeded, you will be informed by email. This ensures that you can increase the Whois request limit in time if needed.
When implementing the Whois proxy, keep in mind the 3 queries per second per source IP restriction.

Hostname

whois.autodns3.de

Help

Displays a list of all supported parameters and commands. Descriptions of all the commands and parameters are listed below.

Example Request

whois -h whois.autodns3.de help

Example Response

%
%
%                o.     .
%                 *0$.o$*    Copyright (c)2018 by InterNetX
%        InterNet  $$$0
%          GmbH   .o$$$Io    Restricted rights.
%                _$$'$$o
%               __*    *$$.
%              __         *
%
%
=== Parameter List ===

 +market
	Check for market domains and prices

 +no_forward
	Ask only the first whois server

 +priceclass
	Only works in combination with +v2 and for premium domains!
	Returns the price class of a premium domain.

 +timeout=<timeout>
	Timeout in seconds (default is 5 seconds)

 +v2
	Supports the 3 new status values 'claim', 'premium' and 'premium_claim' for the commands 'check' and 'multi'.

=== Command List ===

 whois tld
	Returns a comma-separated list of all supported top-level domains

 whois domain.de
	Returns the domain status

 whois full domain.de
	Returns the complete whois output

 whois multi domain1,domain2 de,com,net
    or
 whois multi domain1.de,domain2.com,domain3.net
	Returns the status for multiple requests

Commands

tld

Lists all supported TLDs.

whois -h whois.autodns3.de tld

check

Displays the domain status (= domain availability check).

whois -h whois.autodns3.de domain.de

full check

Displays all Whois results for the request. The results that are displayed depend on the type of registry (thin or thick) and on the data that the registry makes available (= full check).

whois -h whois.autodns3.de full domain.de

multi

Shows the domain status for several TLDs.

whois -h whois.autodns3.de multi domain1,domain2 de,com,net
or
whois -h whois.autodns3.de multi domain1.de,domain2.com,domain3.net

claim

Displays the domain claim data (in XML).

whois -h whois.autodns3.de claim domain.de

Parameter

no_forward

+no_forward

The query is only sent to the first responsible Whois server.

timeout

+timeout=<timeout>

Specify the period of time until timeout (in seconds, default is 5 seconds).

v2

+v2

The additional status values premium, claim und premium_claim are returned. Available for the commands "check" and "multi".

priceclass

+priceclass

Displays the price class which is used to determine for how much the domain can be registered for.

whois -h whois.autodns3.de claim domain.de

Returns the domain claim data (in XML)

Domain Status

The domain availability check (command "check") checks the availability of a domain. The following statuses of the domain can be returned.

Status	Bedeutung
free	The domain is available for registration or not listed in the registry's Whois database.
assigned	The domain is already registered. You can not register the domain but it may be possible to transfer the domain, if the registry supports this.
invalid	The domain name is not valid. Please check if the name consists of valid characters.
invalid and/or unsupported top-level-domain	The TLD is not valid or not supported
error	Un unexpected technical error has occurred which prevents the WhoisProxy from displaying a result.
timeout	The Whois server did not respond within a certain amount of time.
remote request limit exceeded	The maximum number of requests permitted by the registry has been reached or exceeded.
reserved	The domain is reserved and cannot be registered.
pending_delete	The domain is in the deletion process and can not be registered at this time
claim	The domain is available but there is a trademark present in the Trademark Clearinghouse for the name and the TLD is currently in the Sunrise Claims Period. See http://newgtlds.icann.org/en/program-status/sunrise-claims-periods.
premium	This is a premium domain which can only be queried with the "+v2" parameter. The ordering process is specified by the registry.
premium_claim	The following statuses apply: "premium" and "claim".
market	The domain is offered for sale.

Examples

Check

Example Request

whois -h whois.autodns3.de example.com

Example Response

%
% 
%                o.     .
%                 *0$.o$*    Copyright (c)2017 by InterNetX
%        InterNet  $$$0
%          GmbH   .o$$$Io    Restricted rights.
%                _$$'$$o
%               __*    *$$.
%              __         *
%  
%
% Whois-Server: whois.crsnic.net
example.com: assigned

Check with +v2

Example Request

whois -h whois.autodns3.de +v2 00.claims

Example Response

%
% 
%                o.     .
%                 *0$.o$*    Copyright (c)2017 by InterNetX
%        InterNet  $$$0
%          GmbH   .o$$$Io    Restricted rights.
%                _$$'$$o
%               __*    *$$.
%              __         *
%  
%
00.claims: premium

+market

Requests WITHOUT "+market" And WITHOUT "+v2"

> whois -h whois.autodns3.de sedo-premium-domain.com
sedo-premium-domain.com: assigned

> whois -h whois.autodns3.de sedo-domain.com
sedo-domain.com: assigned

> whois -h whois.autodns3.de premium-domain.com
premium-domain.com: free

> whois -h whois.autodns3.de assigned-domain.com
assigned-domain.com: assigned

> whois -h whois.autodns3.de free-domain.com
free-domain.com: free

Requests WITH "+market" und WITHOUT "+v2"

> whois -h whois.autodns3.de +market sedo-premium-domain.com
sedo-premium-domain.com: market,990.00EUR

> whois -h whois.autodns3.de +market sedo-domain.com
sedo-domain.com: market,499.00EUR

> whois -h whois.autodns3.de +market premium-domain.com
premium-domain.com: free

> whois -h whois.autodns3.de +market assigned-domain.com
assigned-domain.com: assigned

> whois -h whois.autodns3.de +market free-domain.com
free-domain.com: free

Requests WITHOUT "+market" und WITH "+v2 +priceclass"

> whois -h whois.autodns3.de +v2 +priceclass sedo-premium-domain.com
sedo-premium-domain.com: assigned

> whois -h whois.autodns3.de +v2 +priceclass sedo-domain.com
sedo-domain.com: assigned

> whois -h whois.autodns3.de +v2 +priceclass premium-domain.com
premium-domain.com: premium,PRICECLASS-XXX

> whois -h whois.autodns3.de +v2 +priceclass assigned-domain.com
assigned-domain.com: assigned

> whois -h whois.autodns3.de +v2 +priceclass free-domain.com
free-domain.com: free

Requests WITH "+market" und WITH "+v2 +priceclass"

> whois -h whois.autodns3.de +market +v2 +priceclass sedo-premium-domain.com
sedo-premium-domain.com: market,990.00EUR

> whois -h whois.autodns3.de +market +v2 +priceclass sedo-domain.com
sedo-domain.com: market,499.00EUR

> whois -h whois.autodns3.de +market +v2 +priceclass premium-domain.com
premium-domain.com: premium,PRICECLASS-XXX

> whois -h whois.autodns3.de +market +v2 +priceclass assigned-domain.com
assigned-domain.com: assigned

> whois -h whois.autodns3.de +market +v2 +priceclass free-domain.com
free-domain.com: free

Multi with +v2:

Example Request

whois -h whois.autodns3.de multi +v2 00.claims,000.claims

Example Response

%
% 
%                o.     .
%                 *0$.o$*    Copyright (c)2017 by InterNetX
%        InterNet  $$$0
%          GmbH   .o$$$Io    Restricted rights.
%                _$$'$$o
%               __*    *$$.
%              __         *
%  
%
000.claims: premium
00.claims: premium

Full Check

With the Full Check command you can query the contact data of a domain. Full Check delivers the direct response of the Whois server.

Example Request

whois -h whois.autodns3.de full internetx.com

Example Response (part for TechC)

Tech Name: John Doe
Tech Organization: Example company
Tech Street: Example Street
Tech City: Example city
Tech State/Province: DE
Tech Postal Code: 12345
Tech Phone: +49 .012345 12345
Tech Phone Ext: +49 .012345 12345
Tech Fax: +49 .012345 12345
Tech Email: hostmaster@example.com

Certain registries do not support the "full" parameter for the Whois query. The format of the Whois answer is specified by the respective registry.