You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The DomainTools Python API Wrapper provides an interface to work with our cybersecurity and related data tools provided by our Iris Investigate™and Iris Enrich™ products. It is actively maintained and may be downloaded via <ahref="https://github.com/DomainTools/python_api">GitHub</a> or <ahref="https://pypi.org/project/domaintools-api/">PyPI</a>.
13
+
The DomainTools Python API Wrapper provides an interface to work with our cybersecurity and related data tools provided by our Iris Investigate™, Iris Enrich™, and Iris Detect™ products. It is actively maintained and may be downloaded via <ahref="https://github.com/DomainTools/python_api">GitHub</a> or <ahref="https://pypi.org/project/domaintools-api/">PyPI</a>. See the included README file, the examples folder, and API documentation (https://app.swaggerhub.com/apis-docs/DomainToolsLLC/DomainTools_APIs/1.0#) for more info.
14
14
15
-
Installing the DomainTools' API
15
+
Installing the DomainTools API
16
16
===================
17
17
18
18
To install the API run
@@ -50,6 +50,12 @@ You can get an overview of every endpoint that you can interact with using the b
50
50
help(api)
51
51
```
52
52
53
+
Or if you know the endpoint you want to use, you can get more information about it:
54
+
55
+
```python
56
+
help(api.iris_investigate)
57
+
```
58
+
53
59
If applicable, native Python looping can be used directly to loop through any results:
You can directly get the html, xml, or json version of the response by calling `.(html|xml|json)()` These only work with non AsyncResults:
91
96
```python
92
-
html=str(api.domain_search('google').json())
97
+
json=str(api.domain_search('google').json())
93
98
xml =str(api.domain_search('google').xml())
94
99
html =str(api.domain_search('google').html())
95
100
```
96
101
97
-
Besides the Iris Investigate method letting you lookup domains, it can also be used to search for domains sharing common attributes. For instance, you can pass it an IP to bring back all domains sharing that IP:
98
-
99
-
```python
100
-
api.iris_investigate(ip='ENTER_IP_ADDRESS_HERE')
101
-
```
102
-
103
-
Other args you can use are below:
104
-
-**ip**: Search for domains having this IP.
105
-
-**email**: Search for domains with this email in their data.
106
-
-**email_domain**: Search for domains where the email address uses this domain.
107
-
-**nameserver_host**: Search for domains with this nameserver.
108
-
-**nameserver_domain**: Search for domains with a nameserver that has this domain.
109
-
-**nameserver_ip**: Search for domains with a nameserver on this IP.
110
-
-**registrar**: Search for domains with this registrar.
111
-
-**registrant**: Search for domains with this registrant name.
112
-
-**registrant_org**: Search for domains with this registrant organization.
113
-
-**mailserver_host**: Search for domains with this mailserver.
114
-
-**mailserver_domain**: Search for domains with a mailserver that has this domain.
115
-
-**mailserver_ip**: Search for domains with a mailserver on this IP.
116
-
-**redirect_domain**: Search for domains which redirect to this domain.
117
-
-**ssl_hash**: Search for domains which have an SSL certificate with this hash.
118
-
-**ssl_subject**: Search for domains which have an SSL certificate with this subject string.
119
-
-**ssl_email**: Search for domains which have an SSL certificate with this email in it.
120
-
-**ssl_org**: Search for domains which have an SSL certificate with this organization in it.
121
-
-**google_analytics**: Search for domains which have this Google Analytics code.
122
-
-**adsense**: Search for domains which have this AdSense code.
123
-
-**tld**: Filter by TLD. Must be combined with another parameter.
124
-
-**search_hash**: Use search hash from Iris to bring back domains.
125
-
126
102
If any API call is unsuccesfull, one of the exceptions defined in `domaintools.exceptions` will be raised:
0 commit comments