OpenDXL
Security Intelligence Sharing
DomainTools DXL Service 0.2.1
- opendxl
- 3.8k Downloads
- 0 Comments
Overview
The DomainTools DXL Python service exposes access to the DomainTools API via the Data Exchange Layer (DXL) fabric.
Documentation
See the Wiki for an overview of the DomainTools API DXL Python service and usage examples.
See the DomainTools API DXL Python service documentation for installation instructions, API documentation, and usage examples.
-
Version 0.2.1
- 564 Downloads
DomainTools API DXL Service 0.2.1 Release
Release notes:
- Pinned previous DomainTools library to support Python 2
-
Version 0.2.0
- 1.1k Downloads
DomainTools API DXL Service 0.2.0 Release
Release notes:
- Updated to support both Python 2 and 3
-
Version 0.1.1
- 1.1k Downloads
Release notes:
- Updated to be consistent with bootstrap 0.1.4
-
Version 0.1.0
- 1.1k Downloads
DomainTools DXL Service
Version: 0.1.0
The DomainTools DXL service exposes access to the DomainTools API via the Data Exchange Layer (DXL) fabric.
Solutions
DomainTools DXL Service
The DomainTools DXL Service.
- Version:
-
0.2.0
| DomainTools DXL Python Service |
Services
DomainTools DXL Python Service
The DomainTools DXL service exposes access to the DomainTools API via the Data Exchange Layer (DXL) fabric.
DomainTools DXL Python Service (GitHub)
- Version:
-
0.2.0
Requests
/opendxl-domaintools/service/domaintools/account_information
Provides a quick and easy way to get a snapshot of API product usage for an account.
DomainTools API Documentation: Account Information
{
"format": "json"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"account": {
"active": true,
"api_username": "username"
},
"products": [
{
"absolute_limit": null,
"expiration_date": null,
"id": "account-information",
"per_minute_limit": "5",
"per_month_limit": "100000",
"usage": {
"month": "0",
"today": "0"
}
},
{
"absolute_limit": "10000",
"expiration_date": "2017-07-18",
"id": "domain-profile",
"per_minute_limit": "120",
"per_month_limit": null,
"usage": {
"month": "0",
"today": "0"
}
}
]
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/brand_monitor
Searches across all new domain registrations worldwide, and return result sets consisting of domain names that contain a customer's brand or monitored word/string.
DomainTools API Documentation: Brand Monitor
For a list of attributes that can be used with this command, see: DomainTools API.
{
"query": "domaintools"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/domain_profile
Provides basic domain name registration details and a preview of additional data available from DomainTools membership and report products.
DomainTools API Documentation: Domain Profile
{
"format": "json",
"query": "domaintools"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"history": {
"ip_address": {
"events": 91,
"product_url": "https://research.domaintools.com/research/hosting-history/?q=domaintools.com",
"timespan_in_years": 11
},
"name_server": {
"events": 6,
"product_url": "https://research.domaintools.com/research/hosting-history/?q=domaintools.com",
"timespan_in_years": 9
},
"registrar": {
"earliest_event": "2002-04-12",
"events": 4,
"product_url": "https://research.domaintools.com/research/hosting-history/?q=domaintools.com"
},
"whois": {
"earliest_event": "2001-10-26",
"product_url": "https://research.domaintools.com/research/whois-history/search/?q=domaintools.com",
"records": 4197
}
},
"name_servers": [
{
"product_url": "https://reversens.domaintools.com/search/?q=NS1.P09.DYNECT.NET",
"server": "NS1.P09.DYNECT.NET"
},
{
"product_url": "https://reversens.domaintools.com/search/?q=NS2.P09.DYNECT.NET",
"server": "NS2.P09.DYNECT.NET"
}
],
"registrant": {
"domains": 271,
"name": "DOMAINTOOLS, LLC",
"product_url": "https://reversewhois.domaintools.com/?all[]=DOMAINTOOLS%2C+LLC&none[]="
},
"registration": {
"created": "1998-08-02",
"expires": "2018-08-01",
"registrar": "ENOM, INC.",
"statuses": [
"clientTransferProhibited"
],
"updated": "2017-07-03"
},
"seo": {
"product_url": "https://research.domaintools.com/seo-browser/?domain=domaintools.com",
"score": 75
},
"server": {
"ip_address": "199.30.228.112",
"other_domains": 3,
"product_url": "https://reverseip.domaintools.com/search/?q=domaintools.com"
},
"website_data": {
"meta": [
],
"product_url": "https://whois.domaintools.com/domaintools.com",
"response_code": 200,
"server": "Here and There",
"title": "Home | DomainTools"
}
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/domain_search
Searches for domain names that match the specific request query string.
DomainTools API Documentation: Domain Search
For a list of attributes that can be used with this command, see: DomainTools API.
{
"query": "domain tools"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"query_info": {
"active_only": false,
"anchor_left": false,
"anchor_right": false,
"deleted_only": false,
"exclude_query": "",
"has_hyphen": true,
"has_number": true,
"limit": 100,
"max_length": 25,
"min_length": 1,
"page": 1,
"total_results": 510
},
"results": [
{
"char_count": 11,
"has_active": 1,
"has_deleted": 1,
"has_hyphen": 0,
"has_number": 0,
"hashad_tlds": [
"asia",
"at",
"be",
"biz",
"bz",
"ca",
"xyz"
],
"sld": "domaintools",
"tlds": [
"asia",
"at",
"be",
"biz",
"bz",
"ca",
"xyz"
],
"tlds_count": 84
},
{
"char_count": 19,
"has_active": 1,
"has_deleted": 1,
"has_hyphen": 0,
"has_number": 0,
"hashad_tlds": [
"com"
],
"sld": "domainbusinesstools",
"tlds": [
"com"
],
"tlds_count": 1
}
]
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/domain_suggestions
Provides a list of domain names that are similar to the words in a request query string.
DomainTools API Documentation: Domain Suggestions
{
"query": "domain tools"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"query": "domain tools",
"status_codes": {
"d": "deleted and available again",
"e": "on-hold (pending delete)",
"g": "on-hold (redemption period)",
"h": "on-hold (generic)",
"p": "registered and parked or redirected",
"q": "never registered before",
"w": "registered and active website",
"x": "registered and no website"
},
"suggestions": [
{
"domain": "domainfreetools",
"status": "qqqqqq"
},
{
"domain": "domainusatools",
"status": "qqqqqq"
},
{
"domain": "domainbuytools",
"status": "qqqqqq"
},
{
"domain": "domainnetworktools",
"status": "qqqqqq"
}
],
"tlds": [
"COM",
"NET",
"ORG",
"INFO",
"BIZ",
"US"
]
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/host_domains
Provides a list of domain names that share the same Internet host (i.e. the same IP address). Also see 'Reverse IP' request.
DomainTools API Documentation: Reverse IP (and Host Domains)
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"ip": "64.246.165.240"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/hosting_history
Provides basic domain name registration details and a preview of additional data available from DomainTools membership and report products.
DomainTools API Documentation: Hosting History
{
"format": "json",
"query": "domaintools.com"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"domain_name": "domaintools.com",
"ip_history": [
{
"action": "N",
"action_in_words": "New",
"actiondate": "2004-05-03",
"domain": "DOMAINTOOLS.COM",
"post_ip": "63.247.77.156",
"pre_ip": null
},
{
"action": "C",
"action_in_words": "Change",
"actiondate": "2009-10-24",
"domain": "DOMAINTOOLS.COM",
"post_ip": "204.2.145.27",
"pre_ip": "209.107.205.90"
}
]
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/ip_monitor
Searches the daily activity of all our monitored TLDs on any given IP address.
DomainTools API Documentation: IP Monitor
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "65.55.53.233"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/ip_registrant_monitor
Searches the ownership (Whois) records of IP address allocations for specific search terms.
DomainTools API Documentation: IP Registrant Monitor
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "domaintools"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"added": [
{
"country": "FR",
"ip_from": "51.255.100.224",
"ip_to": "51.255.100.255",
"organization": "INTERNAL USAGE",
"range": "51.255.100.224/27",
"record_date": "2016-01-05",
"record_ip": "51.255.100.255",
"server": "whois.ripe.net"
},
{
"country": "FR",
"ip_from": "51.254.170.224",
"ip_to": "51.254.170.239",
"organization": "PrivateCloud id -831",
"range": "51.254.170.224/28",
"record_date": "2016-01-05",
"record_ip": "51.254.170.224",
"server": "whois.ripe.net"
}
],
"date": "2016-01-06",
"has_more_pages": false,
"modified": [
],
"page": 1,
"query": "ovh",
"record_count": 99,
"removed": [
{
"country": "FR",
"ip_from": "46.105.155.176",
"ip_to": "46.105.155.183",
"organization": "usertestro",
"range": "46.105.155.176/29",
"record_date": "2015-03-09",
"record_ip": "46.105.155.177",
"server": "whois.ripe.net"
},
{
"country": "FR",
"ip_from": "37.59.91.160",
"ip_to": "37.59.91.175",
"organization": "SP&PS",
"range": "37.59.91.160/28",
"record_date": "2015-02-13",
"record_ip": "37.59.91.163",
"server": "whois.ripe.net"
}
]
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/iris
Provides a quick and easy way to get a snapshot of API product usage for an account.
DomainTools API Documentation: Iris Pivot
For a list of attributes that can be used with this command, see: DomainTools API.
Note: At least one field must be chosen from the Iris API parameters (Ex: domain, ip, email, registrar, etc.).
{
"domain": "domaintools.com",
"format": "json"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"limit_exceeded": false,
"message": "Enjoy your data.",
"results": [
{
"admin_contact": {
"city": "SEATTLE",
"country": "us",
"email": [
"memberservices@domaintools.com"
],
"fax": "12068389056",
"name": "DOMAIN ADMINISTRATOR",
"org": "DOMAINTOOLS, LLC",
"phone": "12068389035",
"postal": "98121",
"state": "WA",
"street": "2101 4TH AVE,SUITE 1150"
},
"adsense": "",
"alexa": 2346,
"billing_contact": {
"city": "",
"country": "",
"email": [
],
"fax": "",
"name": "",
"org": "",
"phone": "",
"postal": "",
"state": "",
"street": ""
},
"domain": "domaintools.com",
"google_analytics": 76641,
"whois_url": "https://whois.domaintools.helium/domaintools.com"
}
],
"results_count": 1
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/name_server_monitor
Searches the daily activity of all our monitored TLDs on any given name server.
DomainTools API Documentation: Name Server Monitor
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "DNSPOD.NET"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"alerts": [
{
"action": "Transfer Out",
"domain": "00000000000.PW",
"new_name_server": "i-now.cn",
"old_name_server": "dnspod.net"
},
{
"action": "New",
"domain": "1524PPP.COM",
"new_name_server": "dnspod.net",
"old_name_server": ""
}
],
"date": "2017-07-18",
"limit": 1000,
"name_server": "DNSPOD.NET",
"page": 1,
"page_count": 35,
"total": "34494"
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/parsed_whois
Searches the daily activity of all our monitored TLDs on any given name server.
DomainTools API Documentation: Parsed Whois
{
"format": "json",
"query": "domaintools.com"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"name_servers": [
"NS1.P09.DYNECT.NET",
"NS2.P09.DYNECT.NET",
"NS3.P09.DYNECT.NET",
"NS4.P09.DYNECT.NET"
],
"parsed_whois": {
"contacts": {
"admin": {
"city": "SEATTLE",
"country": "US",
"email": "MEMBERSERVICES@DOMAINTOOLS.COM",
"fax": "12068389056",
"name": "DOMAIN ADMINISTRATOR",
"org": "DOMAINTOOLS, LLC",
"phone": "12068389035",
"postal": "98121",
"state": "WA",
"street": [
"2101 4TH AVE",
"SUITE 1150"
]
},
"billing": {
"city": "",
"country": "",
"email": "",
"fax": "",
"name": "",
"org": "",
"phone": "",
"postal": "",
"state": "",
"street": [
]
},
"registrant": {
"city": "SEATTLE",
"country": "US",
"email": "MEMBERSERVICES@DOMAINTOOLS.COM",
"fax": "12068389056",
"name": "DOMAIN ADMINISTRATOR",
"org": "DOMAINTOOLS, LLC",
"phone": "12068389035",
"postal": "98121",
"state": "WA",
"street": [
"2101 4TH AVE",
"SUITE 1150"
]
},
"tech": {
"city": "SEATTLE",
"country": "US",
"email": "MEMBERSERVICES@DOMAINTOOLS.COM",
"fax": "12068389056",
"name": "DOMAIN ADMINISTRATOR",
"org": "DOMAINTOOLS, LLC",
"phone": "12068389035",
"postal": "98121",
"state": "WA",
"street": [
"2101 4TH AVE",
"SUITE 1150"
]
}
},
"created_date": "1998-08-02T04:00:00+00:00",
"domain": "domaintools.com",
"expired_date": "2018-08-01T04:00:00+00:00",
"name_servers": [
"ns1.p09.dynect.net",
"ns2.p09.dynect.net",
"ns3.p09.dynect.net",
"ns4.p09.dynect.net"
],
"other_properties": {
"dnssec": "unSigned",
"registry_domain_id": "1697312_DOMAIN_COM-VRSN"
},
"registrar": {
"abuse_contact_email": "abuse@enom.com",
"abuse_contact_phone": "14252982646",
"iana_id": "48",
"name": "ENOM, INC.",
"url": "www.enom.com",
"whois_server": "whois.enom.com"
},
"statuses": [
"clientTransferProhibited https://www.icann.org/epp#clientTransferProhibited"
],
"updated_date": "2017-07-03T00:43:03+00:00"
},
"record_source": "domaintools.com",
"registrant": "DOMAINTOOLS, LLC",
"registration": {
"created": "1998-08-02",
"expires": "2018-08-01",
"registrar": "ENOM, INC.",
"statuses": [
"clientTransferProhibited"
],
"updated": "2017-07-03"
},
"whois": {
"date": "2017-07-17",
"record": "Domain Name: DOMAINTOOLS.COM <etc.>..."
}
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/phisheye
PhishEye Domain List returns domain results for monitored terms. Also see 'PhishEye Term List' below.
DomainTools API Documentation: PhishEye
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "apple"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"date": "2016-11-01",
"domains": [
{
"created_date": "2016-10-30",
"domain": "firstexample-apple.com",
"name_servers": [
"ns1.example.com",
"ns2.example.com"
],
"registrant_email": "somebody@example.com",
"registrar_name": "Some Registrar 1",
"risk_score": 88,
"tld": "com"
},
{
"created_date": "2016-10-31",
"domain": "appeltypoexample.com",
"ip_addresses": [
{
"country_code": "US",
"ip": "192.0.2.100"
},
{
"country_code": "US",
"ip": "192.0.2.101"
}
],
"name_servers": [
"ns57.domaincontrol.com",
"ns58.domaincontrol.com"
],
"registrant_email": "somebody2@example.com",
"registrar_name": "GoDaddy.com, LLC",
"risk_score": 24,
"tld": "com"
}
],
"term": "apple"
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/phisheye_term_list
Provides a list of terms that are set up for this account.
DomainTools API Documentation: PhishEye
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/registrant_monitor
Searches the ownership (Whois) records of domain names for specific search terms.
DomainTools API Documentation: Registrant Monitor
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "domaintools"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/reputation
The Reputation API is only available via Enterprise Solutions team, and is not included in a membership. See DomainTools Documentation for more details.
DomainTools API Documentation: Domain Reputation
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "domaintools.com"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/reverse_ip
Provides a list of domain names that share the same Internet host (i.e. the same IP address).
DomainTools API Documentation: Reverse IP
- domain: string
-
(Required) The domain name.
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "domaintools.com"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/reverse_ip_whois
Provides a list of IP ranges that are owned by an Organization.
DomainTools API Documentation: Reverse IP Whois
- query: string
-
One or more terms separated by the pipe character ( '|' ). (Required for a range of results. Not usable if ip is specified)
- ip: string
-
A single full IP Address ( i.e. 65.55.53.233 ). (Required for a single IP result. Not usable if query is specified)
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "google"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"has_more_pages": true,
"page": 1,
"record_count": 1000,
"records": [
{
"country": "TH",
"ip_from": "1.179.248.0",
"ip_to": "1.179.255.255",
"organization": "Static IP address for Google-caching servers",
"range": "1.179.248.0/21",
"record_date": "2015-05-15",
"record_ip": "1.179.249.17",
"server": "whois.apnic.net"
},
{
"country": "US",
"ip_from": "4.3.2.0",
"ip_to": "4.3.2.255",
"organization": "Google Inc.",
"range": "4.3.2.0/24",
"record_date": "2015-05-17",
"record_ip": "4.3.2.1",
"server": "whois.arin.net"
}
],
"total_count": 1105
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/reverse_name_server
Provides a list of domain names that share the same primary or secondary name server.
DomainTools API Documentation: Reverse Name Server
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "domaintools.net"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/reverse_whois
Provides a list of domain names that share the same Registrant Information.
DomainTools API Documentation: Reverse Whois
For a list of attributes that can be used with this command, see: DomainTools API.
{
"format": "json",
"query": "DomainTools LLC"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
- Error Code: 0
/opendxl-domaintools/service/domaintools/whois
Provides the ownership record for a domain name or IP address with basic registration details.
DomainTools API Documentation: Whois Lookup
{
"format": "json",
"query": "domaintools.com"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"name_servers": [
"NS1.P09.DYNECT.NET",
"NS2.P09.DYNECT.NET",
"NS3.P09.DYNECT.NET",
"NS4.P09.DYNECT.NET"
],
"record_source": "domaintools.com",
"registrant": "DOMAINTOOLS, LLC",
"registration": {
"created": "1998-08-02",
"expires": "2018-08-01",
"registrar": "ENOM, INC.",
"statuses": [
"clientTransferProhibited"
],
"updated": "2017-07-03"
},
"whois": {
"date": "2017-07-17",
"record": "Domain Name: DOMAINTOOLS.COM <etc.>..."
}
}
}
- Error Code: 0
/opendxl-domaintools/service/domaintools/whois_history
Provides a list of historic Whois records for a domain name.
DomainTools API Documentation: Whois History
{
"format": "json",
"query": "domaintools.com"
}
The contents of the DXL response payload matches the response provided by the DomainTools API. Please see the DomainTools API Documentation for further details.
{
"response": {
"history": [
{
"date": "2001-10-26",
"is_private": 0,
"whois": {
"name_servers": [
"DNS1.INTERLAND.NET"
],
"record": "Registrant: VRW2 <etc.>...",
"registrant": "VRW2",
"registration": {
"created": "1998-08-02",
"expires": "2002-08-02",
"registrar": "NETWORK SOLUTIONS, INC.",
"statuses": [
"ACTIVE"
]
}
}
},
{
"date": "2003-08-25",
"is_private": 0,
"whois": {
"name_servers": [
"NS1.XXXNAMESERVERS.COM"
],
"record": "Registrant: DomainTools.com <etc.>...",
"registrant": "DomainTools.com",
"registration": {
"created": "1998-08-02",
"expires": "2004-08-01",
"registrar": "TUCOWS, INC.",
"statuses": [
"ACTIVE"
]
}
}
}
],
"record_count": 46
}
}
- Error Code: 0
Definitions
- format: string
-
Output format for response. Supported values are 'json' and 'xml'. Defaults to 'json'.