Overview
The DomainTools API is organized into distinct products with queries that follow a RESTful 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 Parsed Whois API provides parsed information extracted from the raw Whois record. The API is optimized to quickly retrieve the Whois record, group important data together and return a well-structured format. The Parsed Whois API is ideal for anyone wishing to search for, index, or cross-reference data from one or multiple Whois records.
https://api.domaintools.com/v1/domaintools.com/whois/parsed
The successful retrieval and parsing of a record will always return at least two key pieces of information in its response; the most recent Whois record of the domain or IP address range you requested and the parsed out data represented in JSON or XML format. In rare cases, parsing a record may not be successful. If that occurs, the system will respond with an 206 (partial content) and return an error code with error message. It will still return the Whois record even if it has failed to parse.
Parsed Data Format
The Parsed Whois API formatting returns a JSON or XML structure that contains key-value pairing data grouped together by similar data characteristics. Some key data points for domains include contact information for registrant, admins, tech, billing information, registrar information, registrar, name servers, and important date information about the record like expiration, created, and updated. In addition, each piece of data that is parsed is normalized to a consistent format to ensure consistency. Normalization affects dates, country and phone number data as well as lowercases all data parsed. In the event that a normalization could not be applied, the original parsed data is returned for that specific key/value pairing. IP addresses have their own set of parsed and normalized data points such as network ranges and contact information for each range.
Note that not all data elements will be available for all domains or IP addresses. What is available depends on the Whois record returned for that domain or IP address.
Sample Response – Successful Parsed Record for a Domain:
{
response: {
registrant: "DomainTools, LLC",
registration: {
created: "1998-08-02",
expires: "2014-08-01",
updated: "2014-06-27",
registrar: "NAME TRANCE LLC",
statuses: [
"clientTransferProhibited"
]
},
name_servers: [
"NS1.P09.DYNECT.NET",
"NS2.P09.DYNECT.NET",
"NS3.P09.DYNECT.NET",
"NS4.P09.DYNECT.NET"
],
parsed_whois: {
domain: "domaintools.com",
created_date: "1998-08-02T00:00:00",
updated_date: "2013-11-02T06:39:18",
expired_date: "2014-08-02T00:00:00",
statuses: [ ],
name_servers: [
"ns1.p09.dynect.net",
"ns2.p09.dynect.net",
"ns3.p09.dynect.net",
"ns4.p09.dynect.net"
],
registrar: {
name: "CheapRegistrar (R627)",
abuse_contact_phone: "",
abuse_contact_email: "",
iana_id: "",
url: "http://www.cheap-registrar.com",
whois_server: ""
},
contacts: {
registrant: {
name: "Domain Administrator",
org: "DomainTools, LLC",
street: [
"2211 5th Avenue",
"Suite 201"
],
city: "Seattle",
state: "WA",
postal: "98121",
country: "US",
phone: "12068389035",
fax: "12068389056",
email: "[email protected]"
},
admin: {
name: "Domain Administrator",
org: "DomainTools, LLC",
street: [
"2211 5th Avenue",
"Suite 201"
],
city: "Seattle",
state: "WA",
postal: "98121",
country: "US",
phone: "12068389035",
fax: "12068389056",
email: "[email protected]"
},
tech: {
name: "Domain Administrator",
org: "DomainTools, LLC",
street: [
"2211 5th Avenue",
"Suite 201"
],
city: "Seattle",
state: "WA",
postal: "98121",
country: "US",
phone: "12068389035",
fax: "12068389056",
email: "[email protected]"
},
billing: {
name: "",
org: "",
street: [ ],
city: "",
state: "",
postal: "",
country: "",
phone: "",
fax: "",
email: ""
}
},
other_properties: { }
}
whois: {
date: "2014-07-20",
record: "Domain Name: DOMAINTOOLS.COMnRegistrar URL: http://www.cheap-registrar.comnUpdated Date: 2013-11-02 06:39:18nCreation Date: 1998-08-02 00:00:00nRegistrar Expiration Date: 2014-08-02 00:00:00nRegistrar: CheapRegistrar (R627)nRegistrant Name: Domain AdministratornRegistrant Organization: DomainTools, LLCnRegistrant Street: 2211 5th AvenuenRegistrant Street: Suite 201nRegistrant City: SeattlenRegistrant State/Province: WAnRegistrant Postal Code: 98121nRegistrant Country: USnRegistrant Phone: +1.2068389035nRegistrant Fax: +1.2068389056nRegistrant Email: [email protected] Name: Domain AdministratornAdmin Organization: DomainTools, LLCnAdmin Street: 2211 5th AvenuenAdmin Street: Suite 201nAdmin City: SeattlenAdmin State/Province: WAnAdmin Postal Code: 98121nAdmin Country: USnAdmin Phone: +1.2068389035nAdmin Fax: +1.2068389056nAdmin Email: [email protected] Name: Domain AdministratornTech Organization: DomainTools, LLCnTech Street: 2211 5th AvenuenTech Street: Suite 201nTech City: SeattlenTech State/Province: WAnTech Postal Code: 98121nTech Country: USnTech Phone: +1.2068389035nTech Fax: +1.2068389056nTech Email: [email protected] Server: NS1.P09.DYNECT.NETnName Server: NS2.P09.DYNECT.NETnName Server: NS3.P09.DYNECT.NETnName Server: NS4.P09.DYNECT.NETn"
},
}
}
Sample Response – Failed Parsed Record for a Domain:
{
response: {
error: {
code: 206,
message: "We were NOT able to parse the WHOIS record."
},
registrant: "DomainTools, LLC",
registration: {
created: "1998-08-02",
expires: "2014-08-01",
updated: "2014-06-27",
registrar: "NAME TRANCE LLC",
statuses: [
"clientTransferProhibited"
]
},
name_servers: [
"NS1.P09.DYNECT.NET",
"NS2.P09.DYNECT.NET",
"NS3.P09.DYNECT.NET",
"NS4.P09.DYNECT.NET"
],
whois: {
date: "2014-07-20",
record: "Domain Name: DOMAINTOOLS.COMnRegistrar URL: http://www.cheap-registrar.comnUpdated Date: 2013-11-02 06:39:18nCreation Date: 1998-08-02 00:00:00nRegistrar Expiration Date: 2014-08-02 00:00:00nRegistrar: CheapRegistrar (R627)nRegistrant Name: Domain AdministratornRegistrant Organization: DomainTools, LLCnRegistrant Street: 2211 5th AvenuenRegistrant Street: Suite 201nRegistrant City: SeattlenRegistrant State/Province: WAnRegistrant Postal Code: 98121nRegistrant Country: USnRegistrant Phone: +1.2068389035nRegistrant Fax: +1.2068389056nRegistrant Email: [email protected] Name: Domain AdministratornAdmin Organization: DomainTools, LLCnAdmin Street: 2211 5th AvenuenAdmin Street: Suite 201nAdmin City: SeattlenAdmin State/Province: WAnAdmin Postal Code: 98121nAdmin Country: USnAdmin Phone: +1.2068389035nAdmin Fax: +1.2068389056nAdmin Email: [email protected] Name: Domain AdministratornTech Organization: DomainTools, LLCnTech Street: 2211 5th AvenuenTech Street: Suite 201nTech City: SeattlenTech State/Province: WAnTech Postal Code: 98121nTech Country: USnTech Phone: +1.2068389035nTech Fax: +1.2068389056nTech Email: [email protected] Server: NS1.P09.DYNECT.NETnName Server: NS2.P09.DYNECT.NETnName Server: NS3.P09.DYNECT.NETnName Server: NS4.P09.DYNECT.NETn"
},
}
}
Sample Response – Successful Parsed Record for an IP Address:
{
"response": {
"registrant": "AT&T Services, Inc.",
"record_source": "12.0.0.1"
"parsed_whois": {
"networks": [
{
"id": "NET-12-0-0-0-1",
"range": {
"from": "12.0.0.0",
"to": "12.255.255.255",
"cidr": ["12.0.0.0/8"],
"count": 16777216
},
"asn": [""],
"name": "ATT",
"org": "AT&T Services, Inc. (ATTW-Z)",
"parent": "NET12 (NET-12-0-0-0-0)",
"parent_id": "NET-12-0-0-0-0",
"customer": "",
"country": "",
"phone": [],
"descr": ["For abuse issues contact [email protected]"],
"contact_keys": {
"org": ["ATTW-Z"],
"tech": ["IAA17-ARIN"]
},
"status": "Direct Allocation",
"remarks": [],
"notify_email": [],
"mnt_keys": {},
"created_date": "1983-08-23",
"updated_date": "2013-12-19",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/net/NET-12-0-0-0-1",
"other": {}
},
{
"id": "NET-12-0-0-0-2",
"range": {
"from": "12.0.0.0",
"to": "12.0.0.255",
"cidr": ["12.0.0.0/24"],
"count": 256
},
"asn": [""],
"name": "ATT-LIN850-0",
"org": "ATT LINCROFT ORT (ALO-3)",
"parent": "ATT (NET-12-0-0-0-1)",
"parent_id": "NET-12-0-0-0-1",
"customer": "",
"country": "",
"phone": [],
"descr": [],
"contact_keys": {
"org": ["ALO-3"]
},
"status": "Reassigned",
"remarks": [],
"notify_email": [],
"mnt_keys": {},
"created_date": "2004-01-06",
"updated_date": "2004-01-06",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/net/NET-12-0-0-0-2",
"other": {}
}
],
"contacts": [
{
"id": "IAA17-ARIN",
"type": "person",
"name": "IP Address Administration",
"address": [],
"country": "",
"phone": ["17324202071"],
"fax": [],
"email": ["[email protected]"],
"descr": [],
"contact_keys": {},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "",
"updated_date": "",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/poc/IAA17-ARIN",
"other": {}
},
{
"id": "ATTAB-ARIN",
"type": "person",
"name": "ATT Abuse",
"address": [],
"country": "",
"phone": ["19193198130"],
"fax": [],
"email": ["[email protected]"],
"descr": [],
"contact_keys": {},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "",
"updated_date": "",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/poc/ATTAB-ARIN",
"other": {}
},
{
"id": "IPSWI-ARIN",
"type": "person",
"name": "IP SWIP",
"address": [],
"country": "",
"phone": ["18886136330"],
"fax": [],
"email": ["[email protected]"],
"descr": [],
"contact_keys": {},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "",
"updated_date": "",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/poc/IPSWI-ARIN",
"other": {}
},
{
"id": "CMU8-ARIN",
"type": "person",
"name": "Muhlhausen, Carl",
"address": [],
"country": "",
"phone": ["17325763052"],
"fax": [],
"email": ["[email protected]"],
"descr": [],
"contact_keys": {},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "",
"updated_date": "",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/poc/CMU8-ARIN",
"other": {}
},
{
"id": "ALO-3",
"type": "organization",
"name": "ATT LINCROFT ORT",
"address": [
"12976 HOLLENBERG",
"BRIDGETON",
"MO",
"63044"
],
"country": "us",
"phone": [],
"fax": [],
"email": [],
"descr": [],
"contact_keys": {
"abuse": ["CMU8-ARIN"],
"tech": ["CMU8-ARIN"]
},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "2003-08-22",
"updated_date": "2011-09-24",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/org/ALO-3",
"other": {}
},
{
"id": "ICC-ARIN",
"type": "person",
"name": "IP Team",
"address": [],
"country": "",
"phone": ["18886136330"],
"fax": [],
"email": ["[email protected]"],
"descr": [],
"contact_keys": {},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "",
"updated_date": "",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/poc/ICC-ARIN",
"other": {}
},
{
"id": "JB3310-ARIN",
"type": "person",
"name": "Borkenhagen, Jay C.",
"address": [],
"country": "",
"phone": ["17324202526"],
"fax": [],
"email": ["[email protected]"],
"descr": [],
"contact_keys": {},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "",
"updated_date": "",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/poc/JB3310-ARIN",
"other": {}
},
{
"id": "ATTW-Z",
"type": "organization",
"name": "AT&T Services, Inc.",
"address": [
"200 S. Laurel AVE.",
"MIDDLETOWN",
"NJ",
"07748"
],
"country": "us",
"phone": [],
"fax": [],
"email": [],
"descr": [
"Contact AT&T Abuse ( [email protected] ) for policy abuse issues.",
"All policy abuse issues sent to other POCs will be disregarded."
],
"contact_keys": {
"abuse": [
"ATTAB-ARIN"
],
"tech": [
"IPSWI-ARIN",
"ICC-ARIN",
"JB3310-ARIN"
]
},
"remarks": [],
"notify_email": [],
"abuse_mailbox": [],
"mnt_keys": {},
"created_date": "2009-12-18",
"updated_date": "2013-01-18",
"changed_by": [],
"source": "",
"ref": "http://whois.arin.net/rest/org/ATTW-Z",
"other": {}
}
],
"routes": [],
"referral_servers": [],
"other_properties": []
},
"whois": {
"date": "2015-11-07",
"record": "NetRange: 12.0.0.0 - 12.255.255.255nCIDR: 12.0.0.0/8nNetName: ATTnNetHandle: NET-12-0-0-0-1nParent: NET12 (NET-12-0-0-0-0)nNetType: Direct AllocationnOriginAS: nOrganization: AT&T Services, Inc. (ATTW-Z)nRegDate: 1983-08-23nUpdated: 2013-12-19nComment: For abuse issues contact [email protected]: http://whois.arin.net/rest/net/NET-12-0-0-0-1nnOrgName: AT&T Services, Inc.nOrgId: ATTW-ZnAddress: 200 S. Laurel AVE.nCity: MIDDLETOWNnStateProv: NJnPostalCode: 07748nCountry: USnRegDate: 2009-12-18nUpdated: 2013-01-18nComment: Contact AT&T Abuse ( [email protected] ) for policy abuse issues.nComment: All policy abuse issues sent to other POCs will be disregarded.nRef: http://whois.arin.net/rest/org/ATTW-ZnnOrgTechHandle: ICC-ARINnOrgTechName: IP TeamnOrgTechPhone: +1-888-613-6330 nOrgTechEmail: [email protected]: http://whois.arin.net/rest/poc/ICC-ARINnnOrgAbuseHandle: ATTAB-ARINnOrgAbuseName: ATT AbusenOrgAbusePhone: +1-919-319-8130 nOrgAbuseEmail: [email protected]: http://whois.arin.net/rest/poc/ATTAB-ARINnnOrgTechHandle: JB3310-ARINnOrgTechName: Borkenhagen, Jay C.nOrgTechPhone: +1-732-420-2526 nOrgTechEmail: [email protected]: http://whois.arin.net/rest/poc/JB3310-ARINnnOrgTechHandle: IPSWI-ARINnOrgTechName: IP SWIPnOrgTechPhone: +1-888-613-6330 nOrgTechEmail: [email protected]: http://whois.arin.net/rest/poc/IPSWI-ARINnnRTechHandle: IAA17-ARINnRTechName: IP Address AdministrationnRTechPhone: +1-732-420-2071 nRTechEmail: [email protected]: http://whois.arin.net/rest/poc/IAA17-ARINnnNetRange: 12.0.0.0 - 12.0.0.255nCIDR: 12.0.0.0/24nNetName: ATT-LIN850-0nNetHandle: NET-12-0-0-0-2nParent: ATT (NET-12-0-0-0-1)nNetType: ReassignednOriginAS: nOrganization: ATT LINCROFT ORT (ALO-3)nRegDate: 2004-01-06nUpdated: 2004-01-06nRef: http://whois.arin.net/rest/net/NET-12-0-0-0-2nnOrgName: ATT LINCROFT ORTnOrgId: ALO-3nAddress: 12976 HOLLENBERGnCity: BRIDGETONnStateProv: MOnPostalCode: 63044nCountry: USnRegDate: 2003-08-22nUpdated: 2011-09-24nRef: http://whois.arin.net/rest/org/ALO-3nnOrgTechHandle: CMU8-ARINnOrgTechName: Muhlhausen, Carl nOrgTechPhone: +1-732-576-3052 nOrgTechEmail: [email protected]: http://whois.arin.net/rest/poc/CMU8-ARINnnOrgAbuseHandle: CMU8-ARINnOrgAbuseName: Muhlhausen, Carl nOrgAbusePhone: +1-732-576-3052 nOrgAbuseEmail: [email protected]: http://whois.arin.net/rest/poc/CMU8-ARINn"
},
}
}
Sample Response – Failed Parsed Record for an IP Address:
{
"response": {
"error": {
"code": 206,
"message": "We were NOT able to parse the WHOIS record."
},
"record_source": "195.234.156.0"
"whois": {
date: "2015-11-09",
record: "inetnum: 193.0.0.0 - 195.255.255.255nnetname: EU-ZZ-193ndescr: To determine the registration information for a morendescr: specific range, please try a more specific query.ndescr: If you see this object as a result of a single IP query,ndescr: it means the IP address is currently in the free pool ofndescr: address space managed by the RIPE NCC.ncountry: EU # Country is in fact world widenadmin-c: IANA1-RIPEntech-c: IANA1-RIPEnstatus: ALLOCATED UNSPECIFIEDnmnt-by: RIPE-NCC-HM-MNTncreated: 2010-03-11T11:17:15Znlast-modified: 2015-09-23T13:18:26Znsource: RIPEn"
},
}
}
If a problem in parsing a record occurs, the response object will contain two keys identified as code and message with corresponding values:
| Error Code | Message |
|---|---|
| 206 | Message: “We were NOT able to parse the WHOIS record” Parsing was unsuccessful due to an unknown formatting of the Whois record. |
| 404 | Message: “We have no recent WHOIS information available for this domain/IP Address.” Typically this error occurs when you request to parse a record for a domain that has not been registered. |
You must provide your
API credentials to use this API.
Sample Queries
Products
- Account Information
- Brand Monitor
- Domain Profile
- Domain Reputation
- Domain Risk Score
- Domain Search
- Hosting History
- IP Monitor
- IP Registrant Monitor
- Iris Detect
- Iris Enrich
- Iris Investigate
- Iris Pivot
- Name Server Monitor
- Parsed Whois
- PhishEye
- Registrant Monitor
- Reverse IP
- Reverse IP Whois
- Reverse Name Server
- Reverse Whois
- Whois History
- Whois Lookup
