Maxmind GeoIP2 database reader for geolocating ip addresses.
C++ JavaScript Python
Clone or download
davidtsai Merge pull request #18 from davidtsai/update_node
Update node version to 6.9.1
Latest commit eae642e Oct 20, 2016


Maxmind GeoIP2 database API for geolocating ip addresses.

Fast native implementation by wrapping libmaxminddb to read MaxMind's GeoIP2 mmdb databases.

For ease of use, this module includes the GeoLite2 database created by MaxMind, available from To get more accurate results, this module can also be used with the GeoIP2 database sold by MaxMind.


npm install --save geoip2

Will compile libmaxminddb and node bindings on install. Currently only tested on Linux (x64) and OS X (x64) running Nodejs 0.12.x or Nodejs 4.x. To add support for more platforms, the config header files need to be generated on the platform from libmaxminddb.


Lookup an ip address:

var geoip2 = require('geoip2');
geoip2.lookupSimple("", function(error, result) {
  if (error) {
    console.log("Error: %s", error);
  else if (result) {


  country: 'US',
  continent: 'NA',
  postal: '98275',
  city: 'Mukilteo',
  location: {
    latitude: 47.9445,
    longitude: -122.3046,
    metro_code: 819,
    time_zone: 'America/Los_Angeles'
  subdivision: 'WA'

You can also lookup the full data record for the address using the lookup() method instead.

To initialize geoip2 with a different database, pass in the file path to the init() method:



Initializes the default database to the specified file.

Cleans up the default database. Shouldn't be called unless you are done looking up addresses.

geoip2.lookup(address, callback)
Looks up the full data record for an address asynchronously. For documentation on the result object returned see:

Looks up the full data record for an address synchronously.

geoip2.lookupSimple(address, callback)
Looks up the simple data record for an address asynchronously.

Looks up the simple data record for an address synchronously.

Underlying class to create different instances of the DB. Only needed for advanced usage.

libmaxminddb might be fast enough that the asynchronous API's are unneccessary. Would be interested to know if anyone has stats for this at very high volume.