Added

{ New } - Subdomain Filtering Feature

✨ New Features

🎯 Subdomain Filtering for Domain Search

  • Added subdomains parameter to /search-by-domain endpoint
  • Filtering capability: Matches against subdomain portions of URLs (e.g., "auth" in "auth.example.com")
  • Key difference from keywords:
    • 🎯 Subdomains: Matches only the subdomain portion of URLs
    • 🔍 Keywords: Matches across the entire URL including paths, parameters, and subdirectories
  • Limit: Maximum 5 subdomains per request
  • Example usage: {"domains": ["example.com"], "subdomains": ["auth", "admin"]}

🔒 Validation Rules

  • Mutual exclusivity: subdomains cannot be used with:
    • keywords or keywords_match parameters
    • external_domains parameter
  • Clear error messages for invalid parameter combinations