laramies /theHarvester

E-mails, subdomains and names Harvester - OSINT

★ 18,326⑂ 2,738👁 347⑃ 2,129● 498▤ 38
PythonGPL-2.0Created 2011-01-01www.edge-security.com/
Download: 4.11.14.11.1 ↓4.11.12026-06-03
+2
Daily
18,326
stars
2,738
forks
347
watchers
2,129
prs
498
issues
38
releases

README

theHarvester

!theHarvester logo




theHarvester gathers open-source intelligence about a domain or organization from search engines, certificate transparency logs, DNS datasets, code repositories, threat-intelligence platforms, and other public sources. It normalizes hostnames, email addresses, IP addresses, URLs, ASNs, people, breach names, and structured evidence from optional actions.

Use theHarvester during the early reconnaissance stage of an authorized security assessment. Run it only against targets you own or have explicit permission to test.

 Quick start

theHarvester requires Python 3.14 and uv. The repository's .python-version lets uv select the required Python version automatically:

bash
git clone https://github.com/laramies/theHarvester.git
cd theHarvester
uv sync
uv run theHarvester -d example.com -b crtsh,certspotter


This first run uses two P0 passive sources that need no API key. Passive means the target is not contacted directly, but the selected providers still receive the target string. The terminal reports each source outcome and any retained findings. A source can complete with zero findings, stop early with partial evidence, or fail without erasing evidence retained by other sources.

See the installation guide for packaged distributions and platform-specific setup.

 Choose how to work

| Interface | Best for | Start with |
| --- | --- | --- |
| CLI | One-off reconnaissance and shell workflows | uv run theHarvester -h |
| HarvestView | Local run history, evidence review, hostname changes, and schedules | uv run harvestview |
| REST API | Authenticated local automation and integrations | http://127.0.0.1:5000/docs |

The CLI, REST API, and HarvestView share one finite-run engine and normalized evidence model. HarvestView provides the local browser interface.

 Common workflows

Query several P0 passive sources:

bash
uv run theHarvester -d example.com -b crtsh,certspotter,commoncrawl


Three discovery sources run at once by default. Use -j or --source-workers to change the worker count. Every selected source still runs.

Run every source that can contribute subdomains:

bash
uv run theHarvester -d example.com -b subdomains


Combine capability selectors, or mix them with explicit source names:

bash
uv run theHarvester -d example.com -b emails,urls,certspotter


Capability selectors form a union and choose which sources run. They do not discard other result types returned by those sources. Available selectors are subdomains, emails, ips, asns, urls, people, and breaches. -b all runs every cataloged P0 passive source. P1 DNS and P2 direct sources require explicit selection.

Pass --limit 0 to remove the shared per-source result cap and local page ceilings. Provider quotas and runtime safeguards still apply. If a provider or safety limit stops a source after retaining results, the run keeps them and records a partial outcome with the stop reason.

Exclude hostname results while retaining other result types:

bash
uv run

Top issues

Latest release

4.11.1 4.11.1 2026-06-03
[4.11.1] - 2026-06-03

 Added
- Add Sherlockeye as an API-key source module by @A1S0N in https://github.com/laramies/theHarvester/pull/2347

 Changed
- Updated runtime dependencies: aiohttp to 3.14.0, fastapi to 0.136.3, and uvicorn to 0.48.0.
- Updated development dependencies: pytest-asyncio to 1.4.0, ruff to 0.15.15, and ty to 0.0.42.
- Updated CI and container maintenance pins, including actions/checkout, github/codeql-action, Docker build/login/metadata actions, and the Python Docker base image digest.
- Updated the package version to 4.11.1.

 New Contributors
 @A1S0N made th

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON