Skip to main content

theHarvester

TheHarvester CI TheHarvester Docker Image CI Rawsec's CyberSecurity Inventory

About

theHarvester is a simple to use, yet powerful tool designed to be used during the reconnaissance stage of a red team assessment or penetration test. It performs open source intelligence (OSINT) gathering to help determine a domain's external threat landscape. The tool gathers names, emails, IPs, subdomains, and URLs by using multiple public resources that include:

Package versions

Packaging status

Install and dependencies

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Clone the repository:

git clone https://github.com/laramies/theHarvester
cd theHarvester

Install dependencies and create a virtual environment:

uv sync

Run theHarvester:

uv run theHarvester

Development

To install development dependencies:

uv sync --all-groups

To run tests:

uv run pytest

To run linting and formatting:

uv run ruff check
uv run ruff format

To protect the optional /additional/* REST API routes, set THEHARVESTER_API_KEY and pass the same value in the X-API-Key header. Those routes return 503 when the key is not configured.

Passive modules

Active modules

  • DNS brute force: dictionary brute force enumeration
  • Screenshots: Take screenshots of subdomains that were found

Modules that require an API key

Documentation to setup API keys can be found at - https://github.com/laramies/theHarvester/wiki/Installation#api-keys

  • bevigil - 50 free queries/month. 1k queries/month $50
  • brave - free plan available. Pro plans for higher limits
  • bufferoverun - 100 free queries/month. 10k/month $25
  • builtwith - 50 free queries ever. $2950/yr
  • censys - 500 credits $100
  • criminalip - 100 free queries/month. 700k/month $59
  • dehashed - 500 credts $15, 5k credits $150
  • dnsdumpster - 50 free querries/day, $49
  • dymo - free tier available, paid plans for higher limits
  • fofa - query credits 10,000/month. 100k results/month $25
  • fullhunt - 50 free queries. 200 queries $29/month, 500 queries $59
  • github-code
  • haveibeenpwned - 10 email searches/min $4.50, 50 email searches/min $22
  • hunter - 50 free credits/month. 12k credits/yr $34
  • hunterhow - 10k free API results per 30 days. 50k API results per 30 days $10
  • intelx - free account is very limited. Business acount $2900
  • leakix - free 25 results pages, 3000 API requests/month. Bounty Hunter $29
  • leaklookup - 20 credits $10, 50 credits $20, 140 credits $50, 300 credits $100
  • mojeek - 5000 free credits $6.50, $1.30 CPM (Personal), $2.60 CPM (Startup), $3.90 CPM (Business)
  • netlas - 50 free requests/day. 1k requests $49, 10k requests $249
  • onyphe - 10M results/month $587
  • pentesttools - 5 assets netsec $95/month, 5 assets webnetsec $140/month
  • projecdiscovery - requires work email. Free monthly discovery and vulnerability scans on sign-up email domain, enterprise $
  • rocketreach - 100 email lookups/month $48, 250 email lookups/month $108
  • securityscorecard - requires a work email
  • securityTrails - 50 free queries/month. 20k queries/month $500
  • sherlockeye - Intermediate $46 month, Advanced $120 month. Enterprise available.
  • shodan - Freelancer $69 month, Small Business $359 month
  • tomba - 25 free searches/month. 1k searches/month $39, 5k searches/month $89
  • venacus - 1 free search/day. 10 searches/day $12, 30 searches/day $36
  • virustotal - 500 free lookups/day, 15.5k lookups/month. Busines accounts requires a work email
  • whoisxml - 2k queries $50, 5k queries $105
  • windvane - 100 free queries
  • zoomeye - 5 free results/day. 30/results/day $190/yr

Comments, bugs, and requests

Main contributors

  • Twitter Follow Matthew Brown @NotoriousRebel1
  • Twitter Follow Jay "L1ghtn1ng" Townsend @jay_townsend1
  • Twitter Follow Lee Baird @discoverscripts

Thanks

  • John Matherly - Shodan project
  • Ahmed Aboul Ela - subdomain names dictionaries (big and small)

Metadata

Release files for harvester-windows 4.11.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for harvester-windows 4.11.1
File Size Uploaded
harvester_windows-4.11.1.tar.gz 109.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for harvester-windows 4.11.1
File Interpreter ABI Platform
harvester_windows-4.11.1-py3-none-any.whl Python 3 none any Details

Total release size: 254.8 kB

Release files / harvester_windows-4.11.1.tar.gz

Download URL harvester_windows-4.11.1.tar.gz
Size 109.8 kB
Tags Source
SHA-256 checksum
How to use checksums
607ef68fe2471709348845cbc60e956ee61d15adbc5b292430cce5bbefc2c3c8
BLAKE2b-256 checksum
How to use checksums
148a3ecad78c3f0168f9a06e77b319b79d5d794708ccde317a86bc52996a07b9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release files / harvester_windows-4.11.1-py3-none-any.whl

Download URL harvester_windows-4.11.1-py3-none-any.whl
Size 145.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f089e7943c7acdff2e554c0085adc34c00ef9b431e481a15eea252abbbed4768
BLAKE2b-256 checksum
How to use checksums
870a4faf093a3eb1c2cbdea6a30f312ebb6f6054c4cc4594092f69ba5afb72fc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

4.11.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page