Overview
DomainTools API Guide: IP
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 IP Monitor API searches the daily activity of all our monitored TLDs on any given IP address. New, Deleted and Transferred domains records can be queried up to 6 days in the past.
https://api.domaintools.com/v1/ip-monitor/?query=65.55.53.233&page=1
NOTE: We are unable to provide a functioning test URL for this product because the data changes each day. See below for a sample response.
By default, the active data set is new or updated domain records on the day you submit your API query. You should design your system to submit one API query per day for each name server you want to monitor. If you experience a temporary failure in your processing routines, you can catch up on missing alerts up to six days back by providing the days_back parameter in your request.
Results are limited to 1000 records per page. To view additional pages, include the page parameter in your request.
IP Monitor Parameters
| Parameters | Description |
|---|---|
| query | Required. The IP Address you wish to query ( i.e. 65.55.53.233 ). |
| days_back | Use this parameter in exceptional circumstances where you need to search domain changes up to six days prior to the current date. Set the value to an integer in the range of 1-6. (default 0) |
| page | If the result set is larger than 1000 records for a given day, request additional pages with this parameter. Set the value to an integer up to a maximum of the returned page_count value. (default 1) |
For best results, schedule your daily update to occur no sooner than 3am Pacific time. This ensures the data has been fully processed and is ready for your use.
Because each query consumes resources regardless of whether a match is found, your API account will be charged for each request you submit to the API even if no domain names match your query.
Sample Response
{
"response": {
"limit": 1000,
"date": "2013-11-18",
"ip_address": "65.49.88.146",
"total": "18551",
"page": 1,
"page_count": 19,
"alerts": [
{
"previous_ip_address": "64.62.224.253",
"new_ip_address": "65.49.88.146",
"action": "Transfer In",
"domain": "0--5.COM"
},
{
"previous_ip_address": "64.62.224.253",
"new_ip_address": "65.49.88.146",
"action": "Transfer In",
"domain": "000045.COM"
},
...
]
}
}
You must provide your
API credentials to use this API.
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
