API Keys · ExploitCraft/ReconNinja Wiki · GitHub
Skip to content

API Keys

ExploitCraft edited this page May 5, 2026 · 1 revision

API Keys

Many ReconNinja modules work without any API keys. Keys are only required to unlock specific integrations or raise rate limits.


Keys at a Glance

Service Flag Required? Free Tier? Get Key
Shodan --shodan-key Yes (for Shodan) No https://account.shodan.io
VirusTotal --vt-key Yes (for VT) Yes (1000 req/day) https://www.virustotal.com/gui/my-apikey
NVD (CVE) --nvd-key No (raises limit) Yes https://nvd.nist.gov/developers/request-an-api-key
GitHub --github-token No (raises limit) Yes https://github.com/settings/tokens
HaveIBeenPwned --hibp-key No (for email lookup) Paid https://haveibeenpwned.com/API/Key
GreyNoise --greynoise-key No (raises limit) Yes (community) https://viz.greynoise.io/account/api-key
Censys --censys-id + --censys-secret Yes (for Censys) Yes https://search.censys.io/account/api
Groq (AI) --ai-key Yes (for Groq AI) Yes (generous) https://console.groq.com/keys
OpenAI (AI) --ai-key Yes (for OpenAI AI) No https://platform.openai.com/api-keys
Gemini (AI) --ai-key Yes (for Gemini AI) Yes https://aistudio.google.com/apikey
Ollama (AI) None No Yes (local) https://ollama.com

Modules That Require No Keys

All of these work out of the box with no API keys:

  • WHOIS (--whois)
  • Wayback Machine (--wayback)
  • SSL analysis (--ssl)
  • Subdomain enumeration (--subdomains)
  • Port scanning (RustScan, Nmap, Masscan)
  • Directory brute-force (--ferox)
  • WAF detection (--waf)
  • CORS scanner (--cors)
  • DNS zone transfer (--dns-zone)
  • JS extraction (--js-extract)
  • Cloud bucket enumeration (--cloud-buckets)
  • GitHub OSINT without token (60 req/hr limit)
  • Email security (--email-security)
  • Breach check domain level (--breach-check)
  • GraphQL scanner (--graphql)
  • JWT scanner (--jwt-scan)
  • ASN / BGP map (--asn-map)
  • Supply chain scan (--supply-chain)
  • K8s / Docker probe (--k8s-probe)
  • DB exposure scan (--db-exposure)
  • SMTP enumeration (--smtp-enum)
  • SNMP scan (--snmp-scan)
  • LDAP enum (--ldap-enum)
  • DevOps scan (--devops-scan)
  • GreyNoise community tier (--greynoise)
  • Typosquat detection (--typosquat)
  • AI with Ollama (--ai --ai-provider ollama)
  • All v8 modules except those that call external APIs

Storing Keys Securely

Use a .env file in the repo root (already in .gitignore):

# .env
SHODAN_KEY=your_key_here
VT_KEY=your_key_here
GROQ_KEY=your_key_here
GITHUB_TOKEN=your_token_here

Then reference them in your shell:

reconninja -t example.com \
  --shodan --shodan-key $SHODAN_KEY \
  --vt --vt-key $VT_KEY \
  --ai --ai-provider groq --ai-key $GROQ_KEY \
  --github-osint --github-token $GITHUB_TOKEN \
  -y

Rate Limits

Service Without Key With Key
NVD CVE API 5 req / 30s 50 req / 30s
GitHub API 60 req / hr 5000 req / hr
GreyNoise Community tier (limited) Full access

Related

Clone this wiki locally