assetfinder icon indicating copy to clipboard operation
assetfinder copied to clipboard

Find domains and subdomains related to a given domain

assetfinder

Find domains and subdomains potentially related to a given domain.

Install

If you have Go installed and configured (i.e. with $GOPATH/bin in your $PATH):

go get -u github.com/tomnomnom/assetfinder

Otherwise download a release for your platform. To make it easier to execute you can put the binary in your $PATH.

Usage

assetfinder [--subs-only] <domain>

Sources

Please feel free to issue pull requests with new sources! :)

Implemented

  • crt.sh
  • certspotter
  • hackertarget
  • threatcrowd
  • wayback machine
  • dns.bufferover.run
  • facebook
    • Needs FB_APP_ID and FB_APP_SECRET environment variables set (https://developers.facebook.com/)
    • You need to be careful with your app's rate limits
  • virustotal
    • Needs VT_API_KEY environment variable set (https://developers.virustotal.com/reference)
  • findsubdomains
    • Needs SPYSE_API_TOKEN environment variable set (the free version always gives the first response page, and you also get "25 unlimited requests") — (https://spyse.com/apidocs)

Sources to be implemented

  • http://api.passivetotal.org/api/docs/
  • https://community.riskiq.com/ (?)
  • https://riddler.io/
  • http://www.dnsdb.org/
  • https://certdb.com/api-documentation

TODO

  • Flags to control which sources are used
    • Likely to be all on by default and a flag to disable
  • Read domains from stdin