/chaos-client

Go client to communicate with Chaos DNS API.

Primary LanguageGoMIT LicenseMIT

License Go Report Card contributions welcome GitHub Release Follow on Twitter Chat on Discord

Chaos

Go client to communicate with Chaos dataset API.

Installation:-

▶ GO111MODULE=on go get -v github.com/projectdiscovery/chaos-client/cmd/chaos

Usage:-

▶ chaos -h

This will display help for the tool. Here are all the switches it supports.

Flag Description Example
-d Domain to find subdomains for chaos -d uber.com
-count Show statistics for the specified domain chaos -d uber.com -count
-o File to write output to (optional) chaos -d uber.com -o uber.txt
-json Print output as json chaos -d uber.com -json
-key Chaos key for API chaos -key API_KEY
-dL File with list of domains (optional) chaos -dL domains.txt
-dns-record-type Filter by dns record type chaos -bbq -d uber.com -dns-record-type cname
-dns-status-code Filter by dns status code chaos -bbq -d uber.com -dns-status-code noerror
-filter-wildcard Filter DNS wildcards chaos -bbq -d uber.com -filter-wildcard
-http-url Print URL of the subdomains chaos -bbq -d uber.com -http-url
-http-title Print title of the URL chaos -bbq -d uber.com -http-title
-http-status-code Print http status code chaos -bbq -d uber.com -http-status-code
-http-status-code-filter Filter http status code chaos -bbq -d uber.com -http-status-code-filter 200
-resp Print DNS record with response chaos -bbq -d uber.com -resp
-resp-only Print the response of DNS record chaos -bbq -d uber.com -dns-record-type cname -resp-only
-silent Make the output silent chaos -d uber.com -silent
-version Print current version of chaos client chaos -version

You can also set the API key as environment variable in your bash profile.

export CHAOS_KEY=CHAOS_API_KEY

How to avail API_KEY

As of now Chaos dataset is in beta for testing and API endpoint access available to invited users only, you can request an invite for yourself here, we are sending out new invites every 2nd monday of the month, singed up and still missing the invites? feel free to shoot us a DM is our Discord server.

Running chaos

In order to get subdomains for a domain, use the following command.

▶ chaos -d uber.com -silent

restaurants.uber.com
testcdn.uber.com
approvalservice.uber.com
zoom-logs.uber.com
eastwood.uber.com
meh.uber.com
webview.uber.com
kiosk-api.uber.com
utmbeta-staging.uber.com
getmatched-staging.uber.com
logs.uber.com
dca1.cfe.uber.com
cn-staging.uber.com
frontends-primary.uber.com
eng.uber.com
guest.uber.com
kiosk-home-staging.uber.com

To get the number of subdomains count, you can use the count flag.

▶ chaos -d uber.com -count -silent

7685

👨‍💻 Community

You are welcomed to join our Discord Community. You can also follow us on Twitter to keep up with everything related to chaos project.

💡 Notes

  • The API is rate-limited to 1 request at a time per token.
  • Chaos API only supports domain name to query.
  • Chaos recon data can be retrieved using bbq flag.

📌 Reference

Thanks again for your contribution and keeping the community vibrant. ❤️