DomainTools API Guide: Reverse IP

The DomainTools API is organized into distinct products with queries that follow a REST-ful URL structure wherever possible. Each product offers free, un-authenticated access for the sample URLs listed with each product. If you haven't already, you may want to review the getting started document to learn about authentication and response formats.

The Reverse IP API provides a list of domain names that share the same Internet host (i.e. the same IP address). You can request an IP address directly, or you can provide a domain name; if you provide a domain name, the API will respond with the list of other domains that share the same IP.

  http://api.domaintools.com/v1/nameintel.com/reverse-ip/

  http://api.domaintools.com/v1/66.249.17.251/host-domains/
	

When a domain name resolves to multiple IP addresses, the ip_addresses response node will have several containers, each with an ip_address, domain_count and domain_names node. Otherwise, those nodes will be included directly as children of the ip_addresses node.

Important: Your API account will be charged per domain name returned in the response, not per domain or IP address sent in the request. You will also be charged for duplicate requests.

Use the optional limit parameter to control the size of the result list, and therefore the price, of your query. Domains that resolve to multiple IP addresses may return more than the limit you set if your request is for a domain name instead of an IP address. We recommend requesting explicit IP addresses whenever possible to avoid this uncertainty.

If the domain_count response node is greater than the count of elements in the domain_list node, your query has been limited to only the first set of domains on that IP address, listed alphabetically. The limit may come from your service level or the limit parameter you set in your request.

If you want to estimate the size of a query before incurring the charge on your account, make the request with the limit parameter set to zero (limit=0) and check the value of the domain_count node. You must not, however, use this technique as a replacement for the Domain Profile API to determine the number of domain names on an IP address. We expect to see a reasonable ratio of estimates to actual data requests.