Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Stripped down version of geoip-lite
branch: master

This branch is 1 commit ahead, 21 commits behind bluesmoon:master

Failed to load latest commit information.
test stripped down to IPv4 and country lookup only
LICENSE initial commit, add license before anything else


Stripped down node-geoip-lite. Only supports country lookup and IPv4.

Software is written by Philip Tellis, latest version is available at


var geoip = require('geoip-lite');

var ip = "";
var geo = geoip.lookup(ip);

{ range: [ 3479299040, 3479299071 ],
  country: 'US',
  region: '' }


1. get the library

$ npm install geoip-lite-country

2. get the datafiles

Then download the city data files from You need to get geoip-city.dat and geoip-city-names.dat and put them into the data/ directory of this package.


Looking up an IP address

If you have an IP address in dotted quad notation, IPv6 colon notation, or a 32 bit unsigned integer (treated as an IPv4 address), pass it to the lookup method. Note that you should remove any [ and ] around an IPv6 address before passing it to this method.

var geo = geoip.lookup(ip);

If the IP address was found, the lookup method returns an object with the following structure:

   range: [ <low bound of IP block>, <high bound of IP block> ],
   country: 'XX',                 // 2 letter ISO-3166-1 country code

The actual values for the range array should be considered internal to geoip-lite. To get a human readable format, pass them to geoip.pretty()

If the IP address was not found, the lookup returns null

Pretty printing an IP address

If you have a 32 bit unsigned integer, or a number returned as part of the range array from the lookup method, the pretty method can be used to turn it into a human readable string.

    console.log("The IP is %s", geoip.pretty(ip));

This method returns a string if the input was in a format that geoip-lite can recognise, else it returns the input itself.


geoip-lite is Copyright 2011-2012 Philip Tellis and the latest version of the code is available at


There are two licenses for the code and data. See the LICENSE file for details.

Something went wrong with that request. Please try again.