IP Risk
The IP Risk feed provides risk intelligence for all IP addresses that host domains, regardless of risk level. This feed includes enrichment data: threat scores, geographic information, ASN details, and domain hosting metrics.
Overview
Section titled “Overview”This feed captures all IP addresses that actively host one or more domains, providing risk assessment and enrichment data for each IP address. The feed includes both confirmed threats from third-party intelligence feeds and predictive risk scores based on DomainTools machine learning models.
Use this feed when you need to:
- Monitor IP addresses hosting domains for threat intelligence
- Analyze hosting infrastructure risk patterns
- Correlate IP-based threats with domain activity
- Build IP reputation databases
- Detect suspicious hosting patterns
- Enrich security alerts with IP risk context
- Track threat actor infrastructure
Inclusion criteria: IP address actively hosts one or more domains (regardless of risk level).
Daily download format: Gzip-compressed tab-separated (TSV) text file
Size: 15-20 million IP addresses, ~200MB compressed
Quick Start
Section titled “Quick Start”Get started with the IP Risk feed in under 60 seconds using the Real-time Feed API:
# Start polling for IP risk datacurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySession'This returns the last hour of data. Call again with the same sessionID to get only new data since your last request. See Real-time Feed API for complete details and Authentication for auth options.
Requirements
Section titled “Requirements”You need the following to access Threat Feeds:
- An Enterprise Account with DomainTools, accessible at https://account.domaintools.com/my-account/
- Authentication credentials (API key for header authentication, or API username and key for HMAC or open key authentication)
- A way to interact with a REST API delivered through AWS
Obtain your API credentials from your group’s API administrator. API administrators can manage their API keys at https://research.domaintools.com, selecting the drop-down account menu and choosing API admin.
For assistance, contact enterprisesupport@domaintools.com.
Authentication
Section titled “Authentication”You can authenticate to the IP Risk API using three different methods. Choose the method that best fits your security requirements and technical environment.
API key (header) authentication
Section titled “API key (header) authentication”Authenticate your requests by including the API key in the header of each HTTP request. The API key serves as a unique identifier and authenticates your requests.
Required header:
X-Api-Key: $DOMAINTOOLS_API_KEY
Examples:
# Feed API requestcurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySession'# Download API requestcurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/download/iprisk/'HMAC authentication
Section titled “HMAC authentication”HMAC authentication is a secure alternative to API key-based methods. It requires signing each request with an HMAC digest derived from your API key, providing integrity and authenticity without exposing credentials directly in the request.
This method is recommended for systems where authentication credentials shouldn’t be stored in plain text or included directly in request URLs.
DomainTools supports MD5, SHA1, and SHA256 for the hashing algorithm. Use SHA256 — it’s the recommended choice and is more resistant to collision attacks than MD5 or SHA1.
Required query parameters:
api_username: Your DomainTools API usernamesignature: HMAC-SHA256 signature ofapi_username + timestamp + uri_pathtimestamp: Current UTC timestamp in ISO 8601 format (for example,2025-06-01T15:30:00Z)
Constructing the HMAC signature:
signature = HMAC-SHA256(api_key, api_username + timestamp + uri_path)Example Python signing function:
import hmacimport hashlib
def sign(api_username, api_key, timestamp, uri): params = f"{api_username}{timestamp}{uri}" return hmac.new(api_key.encode("utf-8"), params.encode("utf-8"), hashlib.sha256).hexdigest()Examples:
# Feed API request with HMACcurl 'https://api.domaintools.com/v1/feed/iprisk/?api_username=YOUR_USERNAME&signature=HMAC_SIGNATURE×tamp=2025-01-06T15:30:00Z&sessionID=mySession'# Download API request with HMACcurl 'https://api.domaintools.com/v1/download/iprisk/?api_username=YOUR_USERNAME&signature=HMAC_SIGNATURE×tamp=2025-01-06T15:30:00Z'Open key authentication
Section titled “Open key authentication”This is the easiest authentication scheme to implement, but also the least secure. Each request contains the full API key and API username as query parameters. We recommend using API key header authentication or HMAC authentication instead.
If you’re unsure about your authentication options, contact enterprisesupport@domaintools.com.
Required query parameters:
api_username: Your API usernameapi_key: Your API key
Examples:
# Feed API requestcurl 'https://api.domaintools.com/v1/feed/iprisk/?api_username=YOUR_USERNAME&api_key=YOUR_API_KEY&sessionID=mySession'# Download API requestcurl 'https://api.domaintools.com/v1/download/iprisk/?api_username=YOUR_USERNAME&api_key=YOUR_API_KEY'Real-time Feed API
Section titled “Real-time Feed API”The Real-time Feed API provides streaming access to IP Risk data as risk assessments are updated. This enables real-time monitoring of hosting infrastructure threats and immediate detection of changes in IP risk profiles.
Base URL
Section titled “Base URL”https://api.domaintools.com/v1/feed/iprisk/Feed API rate limits
Section titled “Feed API rate limits”Real-time feeds have the following rate limits:
- 2 queries per minute
- 120 queries per hour
If you exceed these limits, the API returns an error.
Feed API response formats
Section titled “Feed API response formats”The API supports two response formats:
NDJSON (Newline-Delimited JSON)
- Default format when no
Acceptheader is specified - Also known as JSON Lines (JSONL)
- One JSON object per line
- Efficient for streaming and processing large datasets
- Set
Accept: application/x-ndjsonto explicitly request this format
CSV (Comma-Separated Values)
- Set
Accept: text/csvto request CSV format - Add
&headers=1to the query parameters to include column headers as the first line - Not available for all feeds; check the specific feed documentation for CSV support
Feed API session management
Section titled “Feed API session management”Session management allows you to maintain your position in the feed data stream, ensuring you don’t miss or duplicate events when polling the API.
How sessions work:
- Start a new session: Provide a unique
sessionIDparameter of your choosing. By default, the API returns the past hour of results. - Resume a session: Use the same
sessionIDin subsequent requests. The API returns all data since your last request. - Handle large result sets: If a single request exceeds 10M results, the API returns an HTTP
206response code. Repeat the same request with the samesessionIDto receive the next batch of data until you receive an HTTP200response code. - One request at a time: Do not send simultaneous requests with the same
sessionIDfor the same feed. Wait for each request to complete before sending the next one. Concurrent requests with the samesessionIDcan produce errors or incomplete results. - Delete a session: Use an HTTP
DELETErequest with yoursessionIDto clear the saved offset and start fresh.
Session ID requirements:
- 1 to 64 characters in length
- Alphanumeric characters and hyphens only (
[a-zA-Z0-9-]+) - Case-sensitive
Feed API quick start
Section titled “Feed API quick start”Start a new session:
curl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySOC'A new sessionID returns the last hour of data by default.
Continue polling for new updates:
# Call again with the same sessionID to get only new data since last callcurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySOC'Feed API parameters
Section titled “Feed API parameters”Session management
Section titled “Session management”sessionID
Section titled “sessionID”Type: String
Valid values: 1-64 alphanumeric characters and hyphens ([a-zA-Z0-9-]+)
Description: A unique identifier for the session, used for resuming data retrieval from the last point. Use a new sessionID to begin a new session, fetching the most recent hour by default. Reuse the same sessionID to return all feed data since your last request. If omitted, time window parameters (such as after/before) are required.
Example: sessionID=mySOC
Required: Yes, to continue where you left off (or use after/before instead)
Type: Integer or string
Valid values:
- Integer: -1 to -432,000 (relative seconds before current time)
- String: ISO 8601 datetime in UTC format (
YYYY-MM-DDTHH:MM:SSZ)
Description: The start of the query window (inclusive). When using an integer, the value is in seconds relative to the current time. When using a string, provide an absolute timestamp. The query window covers the most recent 5 days. A value older than 5 days is capped to the start of that window, and the response begins 5 days back.
Example: after=-60 or after=2024-10-16T10:20:00Z
Required: Yes, if before or sessionID not provided
before
Section titled “before”Type: Integer or string
Valid values:
- Integer: -1 to -432,000 (relative seconds before current time)
- String: ISO 8601 datetime in UTC format (
YYYY-MM-DDTHH:MM:SSZ)
Description: The end of the query window (inclusive). When using an integer, the value is in seconds relative to the current time. When using a string, provide an absolute timestamp. The query window covers the most recent 5 days. A value older than 5 days places the window entirely outside it, and the response contains no records.
Example: before=-120 or before=2024-10-16T10:20:00Z
Required: Yes, if after or sessionID not provided
fromBeginning
Section titled “fromBeginning”Type: Boolean
Valid values: true, false, 1, 0
Description: Requires a sessionID. Set fromBeginning=true on the first request with a new session ID to return the first hour of data in the time window rather than the last. false is the default. Using it with a session ID that already exists returns HTTP 406, so drop fromBeginning from subsequent requests. Using it without a sessionID, or passing a value that isn’t a boolean, returns HTTP 422.
Example: fromBeginning=true
Required: No
IP Risk filter parameters
Section titled “IP Risk filter parameters”The following filter parameters are specific to the IP Risk and IP Hotlist feeds. Use these to narrow results based on threat metrics, domain activity, and infrastructure characteristics.
pdns_resolutions_min
Section titled “pdns_resolutions_min”Type: Integer
Valid values: Positive integer
Description: Filter for IPs with at least this many domains seen in the last 24 hours.
Example: pdns_resolutions_min=10
Required: No
bad_pdns_resolutions_min
Section titled “bad_pdns_resolutions_min”Type: Integer
Valid values: Positive integer
Description: Filter for IPs with at least this many confirmed bad domains seen in the last 24 hours.
Example: bad_pdns_resolutions_min=5
Required: No
total_domains_max
Section titled “total_domains_max”Type: Integer
Valid values: Positive integer
Description: Filter for IPs with no more than this many total domains (useful to exclude superhoster IPs).
Example: total_domains_max=1000
Required: No
third_party_threats_min
Section titled “third_party_threats_min”Type: Integer
Valid values: Positive integer
Description: Filter for IPs with at least this many domains confirmed with threats on third-party intel feeds.
Example: third_party_threats_min=3
Required: No
all_threats_combined_percent_min
Section titled “all_threats_combined_percent_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains are confirmed or predicted malicious.
Example: all_threats_combined_percent_min=50
Required: No
combined_phishing_percent_min
Section titled “combined_phishing_percent_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains are confirmed or predicted as phishing.
Example: combined_phishing_percent_min=25
Required: No
combined_malware_percent_min
Section titled “combined_malware_percent_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains are confirmed or predicted as malware.
Example: combined_malware_percent_min=25
Required: No
combined_spam_percent_min
Section titled “combined_spam_percent_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains are confirmed or predicted as spam.
Example: combined_spam_percent_min=25
Required: No
Type: Integer
Valid values: Autonomous system number, digits only (no AS prefix, no wildcards)
Description: Filter for IPs with a specific autonomous system number (routing provider).
Example: asn=15169
Required: No
organization
Section titled “organization”Type: String
Valid values: Organization name
Description: Filter for IPs associated with a specific organization. Matches the exact value only. Wildcards aren’t supported.
Example: organization=Example Hosting Inc
Required: No
country_code
Section titled “country_code”Type: String
Valid values: Two-letter country code
Description: Filter for IPs geolocated to a specific country.
Example: country_code=CN
Required: No
all_threats_percent_min
Section titled “all_threats_percent_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains include all threat types.
Example: all_threats_percent_min=40
Required: No
percent_phishing_min
Section titled “percent_phishing_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains are confirmed phishing.
Example: percent_phishing_min=20
Required: No
percent_malware_min
Section titled “percent_malware_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains are confirmed malware.
Example: percent_malware_min=20
Required: No
percent_spam_min
Section titled “percent_spam_min”Type: Integer
Valid values: 0-100
Description: Filter for IPs where at least this percentage of total_domains are confirmed spam.
Example: percent_spam_min=20
Required: No
Result formatting
Section titled “Result formatting”Type: Integer
Valid values: Positive integer, 1-1,000,000,000
Description: Limits the number of results in the response payload. Primarily intended for testing.
Example: top=10
Required: No
headers
Section titled “headers”Type: Boolean
Valid values: true, false, 1, 0
Description: Adds a header row as the first line of the response when text/csv is requested. Set headers=1 to enable; false is the default. Enabling it on a request that doesn’t ask for text/csv returns HTTP 422, as does a value that isn’t a boolean.
Example: headers=1
Required: No
Feed API response structure
Section titled “Feed API response structure”The Feed API returns NDJSON (newline-delimited JSON) with one IP entry per line. Each entry includes a timestamp field indicating when the risk assessment was updated, plus all IP risk and enrichment fields.
Response fields:
timestamp (string): ISO 8601 UTC timestamp when the risk assessment was updated
Note: For real-time feeds, the total_domains field reflects domains seen over the last 30 days (not 7 days as in the daily feed).
Note: Percentage fields are a share of total_domains, truncated to an integer. A computed 37.5 percent is reported as 37.
Example response:
{"timestamp":"2025-01-06T15:30:42Z","ip":"192.0.2.10","asn":12345,"organization":"Example Hosting LLC","city":"Amsterdam","country":"NL","latitude":52.3676,"longitude":4.9041,"pdns_resolutions":12,"bad_pdns_resolutions":3,"total_domains":47,"zerolist_domains":2,"zerolist_ip":false,"third_party_threats":2,"all_threats_combined_count":9,"all_threats_combined_percent":19,"all_threats_percent":19,"combined_phishing_percent":4,"combined_malware_percent":10,"combined_spam_percent":4,"malicious_phishing":1,"malicious_malware":2,"malicious_spam":1,"percent_phishing":4,"percent_malware":10,"percent_spam":4,"compromised_phishing":0,"compromised_malware":1,"compromised_spam":0,"predicted_phishing":1,"predicted_malware":2,"predicted_spam":1}{"timestamp":"2025-01-06T15:30:45Z","ip":"192.0.2.11","asn":67890,"organization":"Cloud Provider Corp","city":"Frankfurt","country":"DE","latitude":50.1109,"longitude":8.6821,"pdns_resolutions":5,"bad_pdns_resolutions":0,"total_domains":18,"zerolist_domains":0,"zerolist_ip":false,"third_party_threats":0,"all_threats_combined_count":1,"all_threats_combined_percent":5,"all_threats_percent":5,"combined_phishing_percent":0,"combined_malware_percent":5,"combined_spam_percent":0,"malicious_phishing":0,"malicious_malware":0,"malicious_spam":0,"percent_phishing":0,"percent_malware":5,"percent_spam":0,"compromised_phishing":0,"compromised_malware":0,"compromised_spam":0,"predicted_phishing":0,"predicted_malware":1,"predicted_spam":0}IP and infrastructure fields
Section titled “IP and infrastructure fields”| Field | Description |
|---|---|
ip | IP address that has www/apex domains pointing to it |
asn | The IP’s ASN (autonomous system number, routing provider) |
organization | Organization associated with IP range based on geo data |
city | City based on IP geo data |
country | Country based on IP geo data |
latitude | Geographic coordinates |
longitude | Geographic coordinates |
Domain activity metrics
Section titled “Domain activity metrics”| Field | Description |
|---|---|
pdns_resolutions | Number of domains seen on the IP in the last 24 hours |
bad_pdns_resolutions | Number of confirmed bad domains seen on the IP in the last 24 hours |
total_domains | Total number of domains seen on this IP in the last 7 days |
zerolist_domains | Number of zero-listed domains seen on this IP |
zerolist_ip | Indicates if this IP is zero-listed (e.g., CDN) |
Threat intelligence metrics
Section titled “Threat intelligence metrics”| Field | Description |
|---|---|
third_party_threats | Number of domains on IP confirmed with any threat on a third-party intel feed |
all_threats_combined_count | Number of confirmed or predicted domains on third-party intel feed or threat profile |
all_threats_combined_percent | Percentage of total_domains that are confirmed or predicted malicious |
all_threats_percent | Percentage of total_domains including all threat types |
Combined threat predictions
Section titled “Combined threat predictions”| Field | Description |
|---|---|
combined_phishing_percent | Percentage of total_domains confirmed or predicted as phishing |
combined_malware_percent | Percentage of total_domains confirmed or predicted as malware |
combined_spam_percent | Percentage of total_domains confirmed or predicted as spam |
Confirmed malicious threats
Section titled “Confirmed malicious threats”| Field | Description |
|---|---|
malicious_phishing | Number of malicious phishing domains on third-party intel feeds |
malicious_malware | Number of malicious malware domains on third-party intel feeds |
malicious_spam | Number of malicious spam domains on third-party intel feeds |
percent_phishing | Percentage of total_domains that are confirmed phishing |
percent_malware | Percentage of total_domains that are confirmed malware |
percent_spam | Percentage of total_domains that are confirmed spam |
Compromised threats
Section titled “Compromised threats”| Field | Description |
|---|---|
compromised_phishing | Number of compromised phishing domains on third-party intel feeds |
compromised_malware | Number of compromised malware domains on third-party intel feeds |
compromised_spam | Number of compromised spam domains on third-party intel feeds |
Predicted threats
Section titled “Predicted threats”| Field | Description |
|---|---|
predicted_phishing | Number of domains (with no confirmed threat) predicted as phishing |
predicted_malware | Number of domains (with no confirmed threat) predicted as malware |
predicted_spam | Number of domains (with no confirmed threat) predicted as spam |
Feed API response codes
Section titled “Feed API response codes”| Code | Status | Description |
|---|---|---|
200 | OK | The request was successful and all data has been delivered |
206 | Partial content | The request was successful, but only a portion of the data was returned. The request exceeded 10M results or the 1-hour evaluation window. Repeat the same request with the same sessionID to receive the next batch of data until you receive an HTTP 200 response |
400 | Bad request | The request is malformed |
403 | Forbidden | Missing or invalid API credentials |
404 | Not found | The requested resource (such as a sessionID) doesn’t exist |
406 | Not acceptable | Either the specified Accept header value isn’t supported (only application/x-ndjson and text/csv are accepted), or fromBeginning was used with a sessionID that already exists |
422 | Unprocessable entity | The request is syntactically valid but violates semantic or domain-specific rules (for example, invalid query parameter values) |
Feed API examples
Section titled “Feed API examples”Basic session polling:
# Start a new sessioncurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySOC'# Resume the session (returns data since last request)curl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySOC'Time window filtering:
# Get data from a specific time rangecurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?after=2025-01-06T10:00:00Z&before=2025-01-06T11:00:00Z'CSV format:
# Request CSV format with headerscurl -H 'Accept: text/csv' -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?headers=1&sessionID=mySOC'# Request CSV format without headerscurl -H 'Accept: text/csv' -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySOC'Limiting the response size:
# Limit the response to 10 recordscurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?top=10&sessionID=mySOC'Filtering by threat metrics:
# IPs with at least 50% of domains confirmed or predicted malicious, excluding superhosterscurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?all_threats_combined_percent_min=50&total_domains_max=1000&sessionID=mySOC'Handling large result sets:
# If you receive HTTP 206, repeat the request to get the next batchcurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySOC'# Repeat until you receive HTTP 200Delete a session:
# Clear the saved offset and start freshcurl -X DELETE -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/feed/iprisk/?sessionID=mySOC'Real-time Download API
Section titled “Real-time Download API”The Real-time Download API provides access to historical IP Risk data through temporary Amazon Web Services (AWS) S3 file links. Files are organized by hour and available for 90 days.
Base URL
Section titled “Base URL”https://api.domaintools.com/v1/download/iprisk/Download API parameters
Section titled “Download API parameters”Type: Integer
Valid values: Positive integer
Description: Limits the number of files returned in the response, starting from the most recent. Use to control payload size or test specific cases.
Example: limit=10
Required: No
Type: Integer
Valid values: Non-negative integer (0, 1, 2, …)
Description: Selects which page of results to return. Pages begin at 0 with the latest results. Use with limit and prefix to control results. The server returns an HTTP 404 (No data to download.) message when the page request exceeds the last page of results.
Example: page=3
Required: No
Type: String
Valid values: Date/time prefix matching the feed’s filename format
Description: Filters results by date using the file prefix. Use with page and limit to control results. Filename prefixes vary by feed. For example, files for this feed begin with the date in YYYY-MM-DD format.
Example: prefix=2025-06-24
Required: No
Download API response structure
Section titled “Download API response structure”The API returns a JSON response containing an array of downloadable files. Each file entry includes:
download_name (string): The feed identifier
files (array): List of downloadable file entries
Each file object contains:
name(string): Path and filename of the downloadable filelast_modified(string): Timestamp of last modification in ISO 8601 UTC formatetag(string): ETag (hash) used to verify file identity and versioningsize(integer): File size in bytesurl(string): Temporary signed URL to download the file from AWS
Download API response codes
Section titled “Download API response codes”| Code | Status | Description |
|---|---|---|
200 | OK | The request was successful |
400 | Bad request | The request is malformed |
401 | Unauthorized | Missing or invalid API credentials |
403 | Forbidden | Missing or invalid API credentials |
404 | Not found | No data to download |
422 | Unprocessable entity | The request is syntactically valid but violates semantic or domain-specific rules (for example, invalid query parameter values) |
Download API file naming
Section titled “Download API file naming”Files follow this naming pattern:
iprisk/YYYY-MM-DD/iprisk-YYYYMMDD.HH00-HH00.json.gziprisk/YYYY-MM-DD/iprisk-YYYYMMDD.HH00-HH00.json.gz.sha256The system produces two files each hour:
- A gzipped JSON data file
- A SHA-256 checksum file for verification
Download API file contents
Section titled “Download API file contents”When uncompressed, the *.json.gz file contains JSON data in the same format as the Feed API response (NDJSON with timestamp and all IP risk fields).
Download API examples
Section titled “Download API examples”List available files:
curl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/download/iprisk/?limit=10'Download and verify a file:
# Get file listcurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/download/iprisk/?limit=2' > files.json
# Extract URLs (select by file extension to avoid index fragility)DATA_URL=$(jq -r '.response.files[] | select(.name | endswith(".json.gz")) | .url' files.json)CHECKSUM_URL=$(jq -r '.response.files[] | select(.name | endswith(".sha256")) | .url' files.json)
# Download filescurl -o iprisk.json.gz "$DATA_URL"curl -o iprisk.json.gz.sha256 "$CHECKSUM_URL"
# Verify checksumsha256sum -c iprisk.json.gz.sha256
# Decompress and viewgunzip iprisk.json.gzhead iprisk.jsonBatch download multiple files:
# Download all files from the last 24 hoursfor url in $(curl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/download/iprisk/?limit=24' | \ jq -r '.response.files[].url' | grep '\.json\.gz$'); do curl -O "$url"doneDaily Download API
Section titled “Daily Download API”The Daily Download API provides access to IP Risk data through temporary AWS S3 file links. The feed is updated daily with risk intelligence for all IPs hosting domains.
Base URL
Section titled “Base URL”https://api.domaintools.com/v1/download/daily_ip_risk/Daily Download parameters
Section titled “Daily Download parameters”The Daily Download API supports standard download parameters. Authentication parameters (api_username, api_key, signature, timestamp) are covered in Authentication.
Type: Integer
Valid values: Positive integer
Description: Limits the number of files returned in the response, starting from the most recent. Use to control payload size or test specific cases.
Example: limit=10
Required: No
Type: Integer
Valid values: Non-negative integer (0, 1, 2, …)
Description: Selects which page of results to return. Pages begin at 0 with the latest results. Use with limit and prefix to control results. The server returns an HTTP 404 (No data to download.) message when the page request exceeds the last page of results.
Example: page=3
Required: No
Type: String
Valid values: Date/time prefix matching the feed’s filename format
Description: Filters results by date using the file prefix. Use with page and limit to control results. Filename prefixes vary by feed. For example, files for this feed begin with the date in YYYY-MM-DD format.
Example: prefix=2025-06-24
Required: No
Daily Download response structure
Section titled “Daily Download response structure”The API returns a JSON response with signed URLs for downloadable files:
download_name (string): The feed identifier (daily_ip_risk)
files (array): List of downloadable file entries
Each file object contains:
name(string): pathlast_modified(string): Last modified date in ISO 8601 formatetag(string): Entity tag (hash of the file)size(integer): Size in bytesurl(string): Signed AWS download URL (valid for 12 hours)
Daily Download response codes
Section titled “Daily Download response codes”200: OK - The request was successful
400: Bad request
401: Unauthorized
403: Forbidden
404: No data to download
Daily Download file naming
Section titled “Daily Download file naming”The feed provides a single file. The name field returned by the API is:
daily_ip_risk/ip_fulllist.gzThis file contains all IP addresses actively hosting domains, updated daily.
File contents
Section titled “File contents”The TSV file contains the following fields (tab-separated, one IP per line):
IP and infrastructure fields
Section titled “IP and infrastructure fields”| Field | Description |
|---|---|
ip | IP address that has www/apex domains pointing to it |
asn | The IP’s ASN (autonomous system number, routing provider) |
organization | Organization associated with IP range based on geo data |
city | City based on IP geo data |
country | Country based on IP geo data |
latitude | Geographic coordinates |
longitude | Geographic coordinates |
Domain activity metrics
Section titled “Domain activity metrics”| Field | Description |
|---|---|
pdns_resolutions | Number of domains seen on the IP in the last 24 hours |
bad_pdns_resolutions | Number of confirmed bad domains seen on the IP in the last 24 hours |
total_domains | Total number of domains seen on this IP in the last 7 days |
zerolist_domains | Number of zero-listed domains seen on this IP |
zerolist_ip | Indicates if this IP is zero-listed (e.g., CDN) |
Threat intelligence metrics
Section titled “Threat intelligence metrics”| Field | Description |
|---|---|
third_party_threats | Number of domains on IP confirmed with any threat on a third-party intel feed |
all_threats_combined_count | Number of confirmed or predicted domains on third-party intel feed or threat profile |
all_threats_combined_percent | Percentage of total_domains that are confirmed or predicted malicious |
all_threats_percent | Percentage of total_domains including all threat types |
Combined threat predictions
Section titled “Combined threat predictions”| Field | Description |
|---|---|
combined_phishing_percent | Percentage of total_domains confirmed or predicted as phishing |
combined_malware_percent | Percentage of total_domains confirmed or predicted as malware |
combined_spam_percent | Percentage of total_domains confirmed or predicted as spam |
Confirmed malicious threats
Section titled “Confirmed malicious threats”| Field | Description |
|---|---|
malicious_phishing | Number of malicious phishing domains on third-party intel feeds |
malicious_malware | Number of malicious malware domains on third-party intel feeds |
malicious_spam | Number of malicious spam domains on third-party intel feeds |
percent_phishing | Percentage of total_domains that are confirmed phishing |
percent_malware | Percentage of total_domains that are confirmed malware |
percent_spam | Percentage of total_domains that are confirmed spam |
Compromised threats
Section titled “Compromised threats”| Field | Description |
|---|---|
compromised_phishing | Number of compromised phishing domains on third-party intel feeds |
compromised_malware | Number of compromised malware domains on third-party intel feeds |
compromised_spam | Number of compromised spam domains on third-party intel feeds |
Predicted threats
Section titled “Predicted threats”| Field | Description |
|---|---|
predicted_phishing | Number of domains (with no confirmed threat) predicted as phishing |
predicted_malware | Number of domains (with no confirmed threat) predicted as malware |
predicted_spam | Number of domains (with no confirmed threat) predicted as spam |
Daily Download examples
Section titled “Daily Download examples”List available files:
curl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/download/daily_ip_risk/'Download the file:
# Get the file listcurl -H "X-Api-Key: $DOMAINTOOLS_API_KEY" \ 'https://api.domaintools.com/v1/download/daily_ip_risk/' > files.json
# Download the filecurl -o ip_fulllist.gz "$(jq -r '.response.files[0].url' files.json)"
# Decompress and viewgunzip ip_fulllist.gzhead ip_fulllistParse TSV data:
# View first 10 IPs: ip, latitude, longitude, pdns_resolutions, bad_pdns_resolutions (cols 1,6,7,8,9)gunzip -c ip_fulllist.gz | head -10 | cut -f1,6,7,8,9