Skip to content
Retrieve IP Geolocation information
Branch: master
Clone or download
Latest commit b967bcd Dec 24, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
core 2.0.4 Apr 21, 2016
logs logs Dec 31, 2015
.gitignore 2.0.1 release Jan 15, 2016
LICENSE Initial commit Dec 12, 2015 Update Dec 24, 2016 create logs folder Jan 22, 2016
requirements.txt requirements Jan 19, 2016



  • A tool to retrieve IP Geolocation information
  • Powered by ip-api


  • Python 3.x
  • termcolor
  • colorama


if pip3 is missing:

  • apt-get install python3-setuptools
  • easy_install3 pip
  • pip3 install -r requirements.txt


  • Retrieve IP or Domain Geolocation.
  • Retrieve your own IP Geolocation.
  • Retrieve Geolocation for IPs or Domains loaded from file. Each target in new line.
  • Define your own custom User Agent string.
  • Select random User-Agent strings from file. Each User Agent string in new line.
  • Proxy support.
  • Select random proxy from file. Each proxy URL in new line.
  • Open IP geolocation in Google Maps using the default browser.
  • Export results to csv, xml and txt format.

Geolocation Information

  • ASN
  • City
  • Country
  • Country Code
  • ISP
  • Latitude
  • Longtitude
  • Organization
  • Region Code
  • Region Name
  • Timezone
  • Zip Code


$ ./
usage: [-h] [-m] [-t TARGET] [-T file] [-u User-Agent]
                        [-U file] [-g] [--noprint] [-v] [--nolog] [-x PROXY]
                        [-X file] [-e file] [-ec file] [-ex file]

IPGeolocation 2.0.4

--[ Retrieve IP Geolocation information from
--[ Copyright (c) 2015-2016 maldevel (@maldevel)
--[ service will automatically ban any IP addresses doing over 150 requests per minute.

optional arguments:
  -h, --help            show this help message and exit
  -m, --my-ip           Get Geolocation info for my IP address.
  -t TARGET, --target TARGET
                        IP Address or Domain to be analyzed.
  -T file, --tlist file
                        A list of IPs/Domains targets, each target in new line.
  -u User-Agent, --user-agent User-Agent
                        Set the User-Agent request header (default: IP2GeoLocation 2.0.3).
  -U file, --ulist file
                        A list of User-Agent strings, each string in new line.
  -g                    Open IP location in Google maps with default browser.
  --noprint             IPGeolocation will print IP Geolocation info to terminal. It is possible to tell IPGeolocation n
ot to print results to terminal with this option.
  -v, --verbose         Enable verbose output.
  --nolog               IPGeolocation will save a .log file. It is possible to tell IPGeolocation not to save those log
files with this option.
  -x PROXY, --proxy PROXY
                        Setup proxy server (example:
  -X file, --xlist file
                        A list of proxies, each proxy url in new line.
  -e file, --txt file   Export results.
  -ec file, --csv file  Export results in CSV format.
  -ex file, --xml file  Export results in XML format.


Retrieve your IP Geolocation

  • ./ -m

Retrieve IP Geolocation

  • ./ -t x.x.x.x

Retrieve Domain Geolocation

  • ./ -t

Do not save .log files

  • ./ -t --nolog

Custom User Agent string

  • ./ -t x.x.x.x -u "Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; rv:11.0) like Gecko"

Using Proxy

Using random Proxy

  • ./ -t x.x.x.x -X /path/to/proxies/filename.txt

Pick User-Agent string randomly

  • ./ -t x.x.x.x -U /path/to/user/agent/strings/filename.txt

Retrieve IP geolocation and open location in Google maps with default browser

  • ./ -t x.x.x.x -g

Export results to CSV file

  • ./ -t x.x.x.x --csv /path/to/results.csv

Export results to XML file

  • ./ -t x.x.x.x --xml /path/to/results.xml

Export results to TXT file

  • ./ -t x.x.x.x -e /path/to/results.txt

Retrieve IP Geolocation for many targets

  • ./ -T /path/to/targets/targets.txt

Retrieve IP Geolocation for many targets and export results to xml

  • ./ -T /path/to/targets/targets.txt --xml /path/to/results.xml

Do not print results to terminal

  • ./ -m -e /path/to/results.txt --noprint
You can’t perform that action at this time.