Domain Profile API

The domain-profile API provides registration details for a domain name and a preview of data available from DomainTools membership and report products.

API endpoint

https://api.domaintools.com/v1/{domain}/

Parameters

Parameter	Type	Description
domain	string	Required. The domain to query. Provided as a path segment in the URL.
format	string	Response format. Valid values: json (default), html, xml.

Example request

curl -X GET \
  'https://api.domaintools.com/v1/domaintools.com/' \
  -H "X-Api-Key: $DOMAINTOOLS_API_KEY"

Sample response

{
    "response": {
        "registrant": {
            "name": "DomainTools, LLC",
            "domains": 5,
            "product_url": "https://reversewhois.domaintools.com/?all[]=DomainTools%2C+LLC&none[]="
        },
        "server": {
            "ip_address": "198.202.211.1",
            "other_domains": 384286,
            "product_url": "https://reverseip.domaintools.com/search/?q=domaintools.com"
        },
        "registration": {
            "created": "1998-08-02",
            "expires": "2027-08-01",
            "updated": "2020-01-09",
            "registrar": "eNom, LLC",
            "statuses": [
                "clientTransferProhibited"
            ]
        },
        "name_servers": [
            {
                "server": "DNS1.P04.NSONE.NET",
                "product_url": "https://reversens.domaintools.com/search/?q=DNS1.P04.NSONE.NET"
            },
            {
                "server": "DNS2.P04.NSONE.NET",
                "product_url": "https://reversens.domaintools.com/search/?q=DNS2.P04.NSONE.NET"
            },
            {
                "server": "DNS3.P04.NSONE.NET",
                "product_url": "https://reversens.domaintools.com/search/?q=DNS3.P04.NSONE.NET"
            },
            {
                "server": "DNS4.P04.NSONE.NET",
                "product_url": "https://reversens.domaintools.com/search/?q=DNS4.P04.NSONE.NET"
            }
        ],
        "history": {
            "registrar": {
                "earliest_event": "",
                "events": 0,
                "product_url": "https://research.domaintools.com/research/hosting-history/?q=domaintools.com"
            },
            "name_server": {
                "events": 1,
                "timespan_in_years": 1,
                "product_url": "https://research.domaintools.com/research/hosting-history/?q=domaintools.com"
            },
            "ip_address": {
                "events": 92,
                "timespan_in_years": 22,
                "product_url": "https://research.domaintools.com/research/hosting-history/?q=domaintools.com"
            },
            "whois": {
                "records": 7432,
                "earliest_event": "2001-10-26",
                "product_url": "https://research.domaintools.com/research/whois-history/search/?q=domaintools.com"
            }
        },
        "seo": {
            "score": "",
            "product_url": ""
        },
        "website_data": {
            "response_code": "",
            "title": "",
            "server": "",
            "meta": [],
            "product_url": "https://whois.domaintools.com/domaintools.com"
        }
    }
}

Not all data elements in the response are available for all domains.

Response fields

registrant

Field	Type	Description
name	string	Registrant name from WHOIS.
domains	integer	Number of domains associated with this registrant.
product_url	string	Link to a Reverse WHOIS search for this registrant.

server

Field	Type	Description
ip_address	string	Current IP address of the domain.
other_domains	integer	Number of other domains sharing this IP address.
product_url	string	Link to a Reverse IP search for this domain.

registration

Field	Type	Description
created	string	Registration creation date (YYYY-MM-DD).
expires	string	Registration expiration date (YYYY-MM-DD).
updated	string	Date the registration was last updated (YYYY-MM-DD).
registrar	string	Registrar name.
statuses	array	EPP status codes for the domain.

name_servers

Array of name server objects.

Field	Type	Description
server	string	Name server hostname.
product_url	string	Link to a Reverse Name Server search for this host.

history

The history object summarizes change counts across four sub-objects: registrar, name_server, ip_address, and whois. Each sub-object contains:

Field	Type	Description
events	integer	Number of recorded change events.
earliest_event	string	Date of the earliest recorded event (YYYY-MM-DD), if available.
timespan_in_years	number	Years spanned by the recorded history (name server and IP sub-objects).
records	integer	Number of historical WHOIS records (WHOIS sub-object only).
product_url	string	Link to the full history in the DomainTools research portal.

website_data

Field	Type	Description
response_code	integer	HTTP response code from the domain’s website.
title	string	HTML title of the domain’s website.
server	string	Web server software reported in the HTTP response.
meta	array	Meta tags from the domain’s website.
product_url	string	Link to the WHOIS record for this domain.

Sample queries

• HTML: https://api.domaintools.com/v1/domaintools.com/?format=html
• JSON: https://api.domaintools.com/v1/domaintools.com/
• XML: https://api.domaintools.com/v1/domaintools.com/?format=xml