GO KALI FREE

PhoneInfoga

Information Gathering

Beginnerlow risk

PhoneInfoga is an open-source OSINT framework for scanning international phone numbers. It first gathers basic information such as country, area, carrier and line type, then runs footprint scanners against public sources to try to find the VoIP provider or identify the owner.

Installation

curl -sSL https://raw.githubusercontent.com/sundowndev/phoneinfoga/master/support/scripts/install | bash

Basic Syntax

phoneinfoga scan -n <phone-number>

Quick Facts

Full Name
PhoneInfoga
License
GPL-3.0
Language
Go (v2)
Category
Phone Number OSINT
Type
OSINT Framework
First Released
2018

Tool Overview

PhoneInfoga is an open-source OSINT framework that scans international phone numbers. It first gathers basic information such as country, area, carrier and line type, then uses a set of scanners to search public sources for footprints — pages, documents or provider clues linked to that number.

Version 2 is written in Go and ships as a single binary with a command-line interface, a browser web UI and a REST API. Its five built-in scanners are local, numverify, googlesearch, googlecse and ovh; the API-backed scanners need keys in a .env file, while the local scanner works with no configuration.

PhoneInfoga is used for scam-number checks, authorized investigations, and OSINT training. Note its upstream status: the project describes itself as stable but unmaintained, so it still works and is widely referenced, but bugs will not be fixed and the repository could be archived — pin a release version when you install it.

Common Commands

phoneinfoga versionPrint the installed PhoneInfoga version
phoneinfoga scan -n +1-555-123-4567Scan a phone number with all enabled scanners
phoneinfoga scan -n +44 20 7946 0018Scan a UK number in international format
phoneinfoga scan -n +1234567890 --disable numverify,googlesearchScan while skipping the numverify and googlesearch scanners
phoneinfoga scan -n +1234567890 --env-file config.envScan using API keys loaded from a specific env file
phoneinfoga scan --helpShow all scan options and flags
phoneinfoga serveStart the web UI and REST API on port 5000
phoneinfoga serve -p 8080Start the web UI and REST API on port 8080
phoneinfoga serve --no-clientServe the REST API only, without the web client
phoneinfoga --helpShow all PhoneInfoga commands and global options
curl -sSL https://raw.githubusercontent.com/sundowndev/phoneinfoga/master/support/scripts/install | bashInstall the latest release binary with the official install script
sudo mv ./phoneinfoga /usr/local/bin/phoneinfogaMove the downloaded binary onto your PATH after the install script
brew install phoneinfogaInstall PhoneInfoga with Homebrew on macOS or Linux
docker pull sundowndev/phoneinfoga:latestDownload the official PhoneInfoga Docker image
docker run --rm -it sundowndev/phoneinfoga scan -n +1-555-123-4567Scan a number inside a throwaway Docker container
docker run --rm -it -p 5000:5000 sundowndev/phoneinfoga serveRun the PhoneInfoga web UI from Docker on port 5000
git clone https://github.com/sundowndev/phoneinfoga.gitClone the source code to build PhoneInfoga yourself
go build -v -o phoneinfoga ./cmd/phoneinfogaBuild the PhoneInfoga binary from source with Go

Step-by-Step Guide

  1. 1Install PhoneInfoga with the official install script, Homebrew, Docker, or by building from source
  2. 2Create a .env file with your API keys (NUMVERIFY_API_KEY, GOOGLE_API_KEY and GOOGLECSE_CX) to unlock the full scanners
  3. 3Run a first scan with phoneinfoga scan -n followed by the number in international format
  4. 4Read the local scanner output for country, carrier and line type, then the footprint results
  5. 5Use phoneinfoga serve to repeat scans from the browser UI or automate them through the REST API

Warnings

Use Cases

Phone Number Validation

Check whether a number is valid and get its country, carrier and line type.

Scam Number Checks

Look up suspicious caller numbers before calling back or reporting them.

OSINT Footprinting

Find web pages and documents where a number appears.

Investigation Support

Enrich an authorized investigation that starts from a phone number.

Key Features

Best Practices

Common Errors

API key is not defined
Add NUMVERIFY_API_KEY (and GOOGLE_API_KEY with GOOGLECSE_CX for googlecse) to a .env file, or pass --env-file with the right file.
given phone number is not valid
Use international format with the country code, for example +1-555-123-4567.
listen: address already in use
Start the server on another port: phoneinfoga serve -p 8080.
phoneinfoga: command not found
Move it with sudo mv ./phoneinfoga /usr/local/bin/phoneinfoga, then run phoneinfoga version.

People Also Ask

What is PhoneInfoga used for?

PhoneInfoga is used for phone number OSINT: validating an international number and gathering public information about it, such as country, carrier, line type and web footprints.

How do I install PhoneInfoga in Kali Linux?

Use the official install script, Homebrew, Docker, or build from source — PhoneInfoga has no APT package in Kali.

Is PhoneInfoga safe?

Yes, it is a legitimate open-source tool. It only queries public sources and APIs; it cannot track a phone or reveal a precise location.

Is PhoneInfoga legal?

The tool is legal, but only use it on numbers you are authorized to investigate. Unauthorized investigation of private individuals can violate privacy laws.

Related Tools

SpiderFoot

Information Gathering

SpiderFoot is an open-source intelligence (OSINT) automation tool that integrates with over 200 public data sources to gather comprehensive intelligence on IP addresses, domain names, email addresses, and names. Created by Steve Micallef in 2012 and released under the MIT license, SpiderFoot automates the entire OSINT collection process with a powerful correlation engine that links findings across multiple data sources. It provides both a web-based UI (SpiderFoot HX) with interactive visualizations and a CLI for automation, making it one of the most popular OSINT frameworks for penetration testers, threat intelligence analysts, and security researchers. SpiderFoot is intended exclusively for authorized security testing, educational purposes, and defensive research.

theHarvester

Information Gathering

theHarvester is a comprehensive OSINT tool for gathering email addresses, subdomains, employee names, open ports, and banners from public sources including search engines, PGP key servers, Shodan, and DNS databases for passive reconnaissance and attack surface mapping.

Sherlock

Social Engineering

Sherlock is an OSINT tool used to track down social media accounts by username across hundreds of social networks to map an individual's online presence.

Recon-ng

Information Gathering

Recon-ng is a full-featured Web Reconnaissance Framework focused on open source intelligence. It provides a powerful environment to conduct web-based reconnaissance quickly and thoroughly via community modules.

Subfinder

Information Gathering

Subfinder is a fast, passive subdomain discovery tool built by ProjectDiscovery. It finds valid subdomains of any target domain by collecting data from dozens of public online sources — Certificate Transparency logs, passive DNS databases, search engines, and threat-intelligence APIs — without ever sending a single packet to the target. Written in Go with a clean modular design, it is a favourite first step for bug bounty hunters, penetration testers, and security researchers who need reliable subdomain enumeration in seconds.

Amass

Information Gathering

OWASP Amass is the industry-standard in-depth network mapping and attack surface discovery tool. It uses active and passive techniques, scraping 20+ public data feeds, DNS enumeration, and certificate transparency logs to discover subdomains, IP addresses, and ASN data — making it essential for penetration testing, bug bounty hunting, and enterprise security assessments.

Related Cybersecurity Guides

OSINT · Beginner

DNS Enumeration Guide: Complete Domain Reconnaissance

Master DNS enumeration techniques from basic queries to advanced zone transfers, subdomain brute forcing, and DNS security assessment using Kali Linux tools.

OSINT · Intermediate

Reconnaissance Workflow: Complete Information Gathering Process

Learn a complete reconnaissance workflow combining OSINT, DNS enumeration, subdomain discovery, and active scanning for comprehensive target profiling.

OSINT · Intermediate

Amass Guide: Open Source Attack Surface Mapping

Learn to use Amass for comprehensive attack surface mapping including DNS enumeration, subdomain discovery, integration with APIs, and visualizations.

OSINT · Intermediate

DNS Enumeration: Uncovering Domain Infrastructure

Learn DNS enumeration techniques to discover domain infrastructure including record types, zone transfers, brute forcing, and DNS security extensions.

Frequently Asked Questions

What is PhoneInfoga used for?

PhoneInfoga is used for phone number OSINT. Give it an international phone number and it reports whether the number is valid, its country, area, carrier and line type, then searches public sources for footprints such as VoIP provider clues or pages where the number appears.

How do I install PhoneInfoga in Kali Linux?

PhoneInfoga has no APT package in Kali, so install it from the official release instead. The fastest route is the install script: curl -sSL https://raw.githubusercontent.com/sundowndev/phoneinfoga/master/support/scripts/install | bash, then move the binary to /usr/local/bin. Docker also works: docker pull sundowndev/phoneinfoga:latest. Homebrew users can run brew install phoneinfoga, and Go users can build from source.

Is PhoneInfoga legal to use?

PhoneInfoga itself is a legal open-source tool, but how you use it decides legality. Only scan numbers you are authorized to investigate, for example your own number, a number in an authorized engagement, or a scam number you are reporting. Investigating private individuals without authorization can violate privacy laws.

Can PhoneInfoga find the owner or location of a phone number?

Sometimes it finds clues, never a certainty. It reports the country, area and carrier reliably, and its footprint scanners may surface pages, documents or VoIP provider hints linked to the number. It does not reveal a precise location, does not track a phone in real time, and does not identify the owner by itself — every hit is an unverified lead to confirm.

Why is PhoneInfoga not working or returning very little data?

The usual cause is missing API keys. The numverify scanner needs NUMVERIFY_API_KEY and the googlecse scanner needs GOOGLE_API_KEY plus GOOGLECSE_CX in a .env file (or passed with --env-file). Without them those scanners error out and only the local scanner returns data. Also check the number is in international format, for example +1-555-123-4567, because an invalid number fails validation before any scanner runs.

PhoneInfoga vs Sherlock — which should I use?

They investigate different identifiers. PhoneInfoga investigates phone numbers (carrier, validity, footprints), while Sherlock investigates usernames across social networks. Use PhoneInfoga when your starting point is a phone number, Sherlock when it is a username, and both together when an investigation has both.

Does PhoneInfoga track a phone in real time?

No. PhoneInfoga only queries public sources and APIs about a number. It cannot track a phone, cannot get a live or precise location, and cannot hack a phone. Any tool claiming to do that from a phone number alone is a scam.

Tags

#osint#phone-number#reconnaissance#information-gathering#footprinting

Output Explanation

Each scan prints one block per scanner. The local scanner reports whether the number is valid plus its country, country code, location, carrier and line type. The numverify scanner adds the same fields from the Numverify API (Valid, Number, Local format, International format, Country prefix, Country code, Country name, Location, Carrier, Line type). The googlesearch and googlecse scanners list web pages where the number appears, and the ovh scanner reports OVH telecom data. Scanners without a configured API key report an error for that block instead of results, so a thin scan usually means missing keys, not a clean number.

Ethical Usage Notice

This tool is designed for authorized security testing, educational purposes, and legitimate network administration only. Unauthorized access to computer systems is illegal.