LinuxCommandLibrary

assetfinder

Enumerate subdomains of a domain

SYNOPSIS

assetfinder [-all|-subs-only] [-hc hides] [-o output] [-r] [-timeout duration] [-t threads] [-wordlist list] [domains...]

PARAMETERS

-all
    Query all available sources (crt.sh, fdns, rpzdns, hackertarget, threatcrowd, alienvault, virustotal, passivetotal, urlscan, censys, chaos)

-subs-only
    Return only subdomains (no wildcards or root domain)

-hc string
    Hide these clean results (comma-separated list, e.g., '*.example.com,example.com')

-o string
    Output file name

-r
    Recursive subdomain enumeration

-timeout int
    HTTP request timeout in seconds (default 10)

-t int
    Number of concurrent threads (default 20)

-wordlist string
    Path to custom wordlist for permutation

-afapi-key string
    AlienVault API key (defaults to $AF_API_KEY env var)

DESCRIPTION

Assetfinder is a fast, lightweight command-line tool designed for passive subdomain enumeration during reconnaissance phases of security assessments and bug bounty hunting. Developed in Go by Tom NomNom, it queries multiple public sources without sending traffic to the target domain, making it stealthy and efficient.

It aggregates subdomains from certificate transparency logs (crt.sh), passive DNS datasets like Rapid7's (fdns, rpzdns), and threat intelligence feeds including AlienVault OTX, VirusTotal, PassiveTotal, URLScan, Censys, and Chaos. By default, it uses a focused set of high-yield sources for speed, but the -all flag enables exhaustive querying.

Assetfinder supports threading for concurrency, recursion for wildcard expansion, custom wordlists for permutation, and output filtering to hide common or irrelevant results. It's particularly valued for its speed—often completing scans in seconds—and reliability, outputting unique, live subdomains ready for further tools like httpx or nuclei. Ideal for OSINT and initial attack surface mapping, it avoids active DNS queries to minimize footprint.

CAVEATS

Not installed by default; requires Go 1.16+. Some sources may rate-limit or require API keys. Recursive mode (-r) can generate high output volume. Results may include stale or parked domains.

INSTALLATION

Run go install github.com/tomnomnom/assetfinder@latest
Requires Go toolchain.

EXAMPLE USAGE

assetfinder -all -o subs.txt example.com
Enumerates all sources and saves to file.

cat subs.txt | httpx -silent
Pipe to httpx for live host probing.

HISTORY

Created by Tom NomNom (Twitter: @tomnomnom) in 2018 as a Go binary for rapid recon. Gained popularity in bug bounty communities via HackerOne/TwitchCon talks. Actively maintained on GitHub with source additions like Chaos dataset integration. Version 0.1.2+ introduced threading and recursion.

SEE ALSO

Copied to clipboard