httpx logo

httpx

Turn a host list into live HTTP services: status codes, titles, TLS details, headers and detected tech in one fast pass. Free, Go CLI.

Overview

ProjectDiscovery httpx is a command-line HTTP toolkit for probing web services and collecting response metadata. It helps turn candidate hostnames into a more useful list of live HTTP(S) endpoints for an authorized assessment.

Key features

HTTP/HTTPS probing; status and title collection; technology and response metadata; stdin and JSON workflows.

Install & first run


# ProjectDiscovery httpx - not the Python httpx library, which also ships an `httpx`
go install -v github.com/projectdiscovery/httpx/cmd/httpx@latest
export PATH="$PATH:$(go env GOPATH)/bin"

# Probe one host for status code, title and detected tech
httpx -u https://lab.example.com -status-code -title -tech-detect

# Turn a subdomain list into the live HTTP services
subfinder -d example.com -silent | httpx -silent -mc 200,302

# Show response headers and CDN/WAF fingerprints
httpx -u https://lab.example.com -headers -cdn

If pip install httpx is already on the machine, call the Go binary by full path to avoid hitting the Python one. Docs: https://docs.projectdiscovery.io/tools/httpx/overview

Real-world example

After passive subdomain discovery, probe the in-scope host list to identify which services respond over HTTP or HTTPS.

Common questions

Is this the Python httpx library?

No. This entry is ProjectDiscovery’s security reconnaissance CLI.

What does it actually check?

Whether a host speaks HTTP(S), then status code, title, TLS details, response headers, detected technologies and CDN/WAF fingerprints.

Why do some hosts time out?

Port 443/80 may be filtered, or the service is not HTTP. Add -ports and -timeout, and remember no response is itself a finding.

Can it screenshot pages?

Not by itself. Chain katana or gau for URLs and use a headless browser for screenshots - httpx stays a fast metadata prober.

dnsx

Resolve and inspect DNS records at scale in a pipeline: A/AAAA/CNAME lookups, wildcard filtering and custom resolvers. Free, open source, Go.

Katana

Crawl web applications for URLs and endpoints, parsing JavaScript and known files so you see the routes a user can really reach. Free, Go CLI.

OWASP Amass

Map an organisation's external attack surface with passive DNS, certificate and WHOIS correlation. Free, open source, an OWASP project.


Keep exploring: browse every assessment phase in the Pentest Hub.

Authorized testing only — only ever test systems you own or have explicit written permission to assess.