Chaos
Chaos (ProjectDiscovery) subdomain enumeration API client
Recon & OSINT5 commands
#subdomain#chaos#recon#api
Installation
1Install Go 1.21+ on your system
2Run the Go install command
3Set CHAOS_API_KEY environment variable
4Verify installation
go install github.com/projectdiscovery/chaos-client/cmd/chaos@latest
# Set API key
export CHAOS_API_KEY="your-api-key-here"
# Verify
chaos -versionBasic Usage
Chaos uses ProjectDiscovery's Chaos dataset to enumerate subdomains from a curated passive database
# Basic enumeration
chaos -d example.com
# Output to file
chaos -d example.com -o subs.txt
# JSON output
chaos -d example.com -o subs.json -json
# Silent mode (subdomains only)
chaos -d example.com -silentCommand Reference
5 commands
1Target domain
-d2Output file path
-o3Output in JSON format
-json4Show only results
-silent5Show total count of results
-countWhen to Use
1
Accessing ProjectDiscovery's curated subdomain dataset2
Validating and enriching subdomain findings3
Bug bounty reconnaissance4
Combining with other ProjectDiscovery toolsNotes & Tips
1
Requires a free API key from https://chaos.projectdiscovery.io2
Dataset updated daily from passive sources3
Not a replacement for active scanning — use with dnsx for resolution4
Results are already validated by the dataset pipelineCommon Errors & Solutions
CHAOS_API_KEY not set
Set the environment variable: export CHAOS_API_KEY='your-key'
Authentication failed
Verify your API key is valid at https://chaos.projectdiscovery.io