Skip to content
The official command line client for IPFinder
Branch: master
Clone or download
Latest commit 1bef4e4 Jun 26, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
Debian/ipfinder Add snapcraft and debian files May 15, 2019
bin update v1.0.2 Jun 24, 2019
dist update v1.0.2 Jun 24, 2019
snap update v1.0.2 Jun 24, 2019
src update v1.0.2 Jun 24, 2019
.editorconfig v1.0.0 Apr 30, 2019
.gitattributes v1.0.0 Apr 30, 2019
.gitignore update v1.0.2 Jun 24, 2019
LICENSE v1.0.0 Apr 30, 2019
VERSION update v1.0.2 Jun 24, 2019
asn.txt update v1.0.2 Jun 24, 2019
composer.json update v1.0.2 Jun 24, 2019
ip-finder-cli.rb Add Homebrew package service Jun 26, 2019
ip.txt v1.0.0 Apr 30, 2019
token.txt v1.0.0 Apr 30, 2019

IPFinder CLI (Command Line Interface)

  • Supports Single IP Address, asn, ranges, firewall as Input
  • Supports Bulk
  • Exports Results to Screen or to An Output File
  • Supports IPv4 and IPv6
  • Supports ASN number , RANGES , Firewall

Getting Started

sign up for a free account at, for Free IPFinder API access token.

The free plan is limited to 4,000 requests a day, and doesn't include some of the data fields To enable all the data fields and additional request volumes see


Visit IPFinder documentation.

System Requirements


Via composer

First, download the IPfinder cli using Composer:

composer global require ipfinder-io/ip-finder-cli

Make sure to place composer's system-wide vendor bin directory in your $PATH so the IPfinder executable can be located by your system. This directory exists in different locations based on your operating system; however, some common locations include:

  • macOS: $HOME/.composer/vendor/bin
  • GNU / Linux Distributions: $HOME/.config/composer/vendor/bin
  • Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

Linux Distributions / macOS

download the IPfinder cli using from github using curl

$ brew tap ipfinder-io/ip-finder-cli
$ brew install ip-fidner-cli
## using curl

$ curl -LO
## using wget
$ wget
$ chmod +x ipfinder.phar
$ sudo mv ipfinder.phar /usr/bin/ipfinder
$ ipfinder -h


  1. Download IPFINDER PHAR from github
  2. Create a directory for PHP binaries; e.g., C:\bin
  3. Open a command line (e.g., press Windows+R » type cmd » ENTER)
  4. Create a wrapping batch script (results in C:\bin\ipfinder.cmd):
C:\Users\username> cd C:\bin
C:\bin> echo @php "%~dp0ipfinder.phar" %* > ipfinder.cmd
C:\bin> exit
  1. Open a new command line and confirm that you can execute IPfinder from any path:
C:\Users\username> ipfinder --help

Command list

shortopts longopts Description
-h --help This help text
-o --output save to a given file
-u --update App Code update
-a --auth lookup your IP address information.
-m --format fetching IP address information.
-i --ip firewall supported format
-n --asn fetching AS number information.
-r --ranges fetching IP Address Ranges information.
-f --firewall fetching firewall information
-d --domain Get information for Domain IP.
-d --dhistory Get information for Domain IP history.
-dl --dlist Get information for list Domain By ASN, Country,Ranges.
-s --status Get information for your token.
-c --config Add your Token and labg
-l --shell Run interactively


Licensed under the Apache-2.0.


Contact Us With Additional Questions About Our API, if you would like more information about our API that isn’t available in our IP geolocation API developer documentation, simply contact us at any time and we’ll be able to help you find what you need..

You can’t perform that action at this time.