v1

latestOpenAPI 3.0.02026-07-24311994.6 KB

Domain Intelligence

Domains Overview

Get overview about domain-wide compromises and intelligence

post/search-by-domain/overview

Request body

domainsstring[] required

List of domains to retrieve compromise overview statistics for. Accepts root domains (example.com) and will aggregate data across all subdomains. Between 1-500 domains can be specified per request.

min_employees_compromisednumber

Minimum threshold for employee compromises. Returns only domains with at least this many compromised employee accounts. Useful for filtering out domains with negligible compromise counts.

max_employees_compromisednumber

Maximum threshold for employee compromises. Returns only domains with no more than this many compromised employee accounts. Useful for focusing on organizations within specific size ranges.

min_users_compromisednumber

Minimum threshold for user compromises. Returns only domains with at least this many compromised user accounts. Helps identify domains with significant consumer impact.

max_users_compromisednumber

Maximum threshold for user compromises. Returns only domains with no more than this many compromised user accounts. Helps focus on domains with specific consumer impact ranges.

last_employee_compromisedstring date-time

ISO 8601 formatted timestamp (YYYY-MM-DDThh:mm:ssZ) to filter for domains with employee compromises after this date. Identifies domains with recent corporate breaches.

last_user_compromisedstring date-time

ISO 8601 formatted timestamp (YYYY-MM-DDThh:mm:ssZ) to filter for domains with user compromises after this date. Identifies domains with recent consumer-facing breaches.

last_employee_uploadedstring date-time

ISO 8601 formatted timestamp (YYYY-MM-DDThh:mm:ssZ) to filter for domains with employee data uploaded after this date. Reflects when the data became available in our system.

last_user_uploadedstring date-time

ISO 8601 formatted timestamp (YYYY-MM-DDThh:mm:ssZ) to filter for domains with user data uploaded after this date. Reflects when the data became available in our system.

Field to sort overview results by. Time-based sorting helps identify recent breaches, while count-based sorting identifies the most severely affected domains.

sort_direction'asc' | 'desc'

Direction to sort overview results. 'desc' prioritizes recent breaches or highest compromise counts (recommended for threat monitoring), while 'asc' shows oldest breaches or lowest counts first.

cursorstring

Base64 encoded pagination cursor for retrieving the next set of overview results. Obtained from the 'nextCursor' field in the previous response. Essential for processing large domain lists.

Example request

{
  "domains": [
    "hpe.com"
  ],
  "min_employees_compromised": 10,
  "max_employees_compromised": 100,
  "min_users_compromised": 5,
  "max_users_compromised": 50
}

Response

Successful operation

nextCursorstring

Base64 encoded cursor for the next page

Example response

{
  "data": [
    {
      "compromised_employees": 25,
      "compromised_users": 120,
      "fortinet": {
        "domain": "example.com",
        "industry": "Financial Services",
        "size": "1001-5000 Employees",
        "revenue": "$500 Million",
        "credentials": [
          {
            "url": "https://vpn.example.com:443/login",
            "login": "david",
            "password": "david",
            "FortiGuardID": "FGT60F-XXXXXXXX",
            "country": "US"
          }
        ]
      }
    }
  ]
}