{ New } - Advanced Search Endpoint

🚀 New Endpoint: POST /advanced-search

Summary

A powerful new endpoint for performing advanced compromise intelligence queries using multiple filters, supporting large-scale threat investigations across employee and user data.

🔍 Description

The /advanced-search endpoint enables clients to execute fine-grained searches across potentially compromised domains using a wide range of filters. Designed for advanced use cases like enterprise threat monitoring, incident response, and intelligence aggregation.

📥 Request Body

Supports a JSON payload with at least one filter required. The following filters are available:

🔑 Primary Filters

• domains[] – Root domains (max 500)
• min_employees_compromised, max_employees_compromised
• min_users_compromised, max_users_compromised
• last_employee_compromised, last_user_compromised (ISO 8601)
• last_employee_uploaded, last_user_uploaded (ISO 8601)

🏢 Enrichment Filters

• company_sizes[] – E.g., ["1-10", "5001-10000"]
• industries[] – Accepts any from 147+ industries
• countries[] – Accepts any of 247 countries

📊 Sorting & Pagination

• sort_by – One of:

  • last_employee_compromised
  • last_user_compromised
  • last_employee_uploaded
  • last_user_uploaded
  • compromised_employees
  • compromised_users

• sort_direction – asc or desc (default: desc)

• cursor – Base64-encoded string for pagination

📤 Response Format

Returns a JSON object containing:

• data[] – List of matching domain summaries with:

  • domain, compromised_employees, compromised_users
  • last_employee_compromised, last_user_compromised
  • last_employee_uploaded, last_user_uploaded
  • company_size, industry, country
  • sensitive_applications[]

• nextCursor – Cursor for pagination

⚠️ Error Responses

• 400 – Validation error
• 401 – Unauthorized
• 403 – Forbidden
• 404 – Not found
• 408 – Request timeout
• 429 – Rate limit exceeded
• 500 – Internal server error

📘 Notes

• At least one filter is required to trigger a search.
• Designed for high-scale forensic or investigative queries.
• Country and industry filters reference live values at: /company-filters.json