# geoip-lite/node-geoip

Native NodeJS implementation of MaxMind's GeoIP API -- works in node 0.6.3 and above, ask me about other versions

Repository: https://github.com/geoip-lite/node-geoip
Canonical: https://ross.abutalabs.com/products/node-geoip
Homepage: https://npmjs.org/package/geoip-lite
Language: JavaScript
License: NOASSERTION
License Family: other
Last push: 2026-06-17T17:12:38+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 88, release rhythm 77, longevity 100
- inputs: {"age_days": 5508, "days_push": 77, "days_rel": 77, "gap_med": 41, "n_releases_24m": 4}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2421, forks 359 (observed 2026-08-28T04:06:50.571106+00:00)

## What it is
A fully native JavaScript Node.js library implementing MaxMind's GeoIP API using GeoLite data files. It performs fast, synchronous IP-to-location lookups returning country, region, city, timezone, and coordinates for both IPv4 and IPv6 addresses.

## Use cases
- look up the country and city of an IP address in node
- geolocate visitor IPs in an express server
- get latitude and longitude from an IP without calling an external API
- fast synchronous IP to geo mapping for nodejs
- resolve IP address timezone and region locally

## When to choose
- you need extremely fast, in-process IP geolocation lookups in Node.js
- you want a pure JavaScript solution without native C library bindings
- you need synchronous lookups with no network calls at request time

## When to avoid
- you need full IPv6 city/region/postal data, which GeoLite does not provide
- you run on memory-constrained instances, since all data is loaded into RAM
- you need the most feature-complete MaxMind API, where libgeoip bindings are better

## Facets
- artifact type: library
- maturity: active
- function: geospatial, sdk, developer-tools
- domain: web-development, backend, analytics
- platform: -
- tags: geoip, ip-geolocation, maxmind, geolite2, synchronous-lookup, maps, nodejs, javascript

## Member repositories
- geoip-lite/node-geoip (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:50.571106+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:33:03.230281+00:00, confidence not recorded.
  - readme: https://github.com/geoip-lite/node-geoip (fetched 2026-08-28T04:06:50.571106+00:00, sha 45feb19ae296)
- Data as of 2026-08-30T08:39:29.467469+00:00.