Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@ip-location-db/geolite2-city

sapics12.5kSEE LICENSE IN GEOLITE2_LICENSE AND GEOLITE2_EULA2.3.2025053119

Ip to location database

ip, ip-location, ip-location-db, ipv4, ipv6, location, city, country

readme

ip-location-db/geolite2-city

Download

Database Type License Updated IPv4 IPv6 IPv4+IPV6 IPv4-num IPv6-num
GeoLite2

npm version
npm version
npm version
City GeoLite2 License by MaxMind Twice weekly CSV.gz
CSV.7z
MMDB
CSV.gz
CSV.7z
MMDB
CSV.gz
CSV.7z
CSV.gz
CSV.7z

CSV Format

ip_range_start, ip_range_end, country_code, city, state1, state2, postcode, latitude, longitude, timezone

ip_range_start and ip_range_end are either IP addresses, or IP addresses in numeric format (depending upon which files you choose) and these two fields represent an inclusive range of IP addresses for that data row.

For example, in the -ipv4.csv files, the CSV line: 1.0.0.0,1.0.0.255,AU would mean that any IP addresses between 1.0.0.0 and 1.0.0.255 (inclusive) are AU. In -ipv4-num.csv files, the equivalent line would be: 16777216,16777471,AU.

For example, in the -ipv6.csv files, the CSV line: 2001:200::,2001:200:ffff:ffff:ffff:ffff:ffff:ffff,JP would mean that any IP addresses between 2001:200:: and 2001:200:ffff:ffff:ffff:ffff:ffff:ffff (inclusive) are JP. In -ipv6-num.csv files, the equivalent line would be: 42540528726795050063891204319802818560,42540528806023212578155541913346768895,JP.

Please be careful when using IPv6 and IPv6-num files in your program, the numerical value exceeds 32bit unsigned integers, and you would need to use a 128bit unsigned integer.

country_code

country_code is the two-letter code defined in ISO 3166-1 alpha-2. You can get the country name, capital, continent, currency, languages, etc. from the country_code by Countries Database in JSON, CSV, SQL format.

Referenced Database and License

GeoLite2 database [Update: Twice weekly]

GeoLite2 is created by MaxMind. The license of GeoLite2 is written in GEOLITE2_LICENSE and End User License Agreement (EULA) is written in GEOLITE2_EULA. Please carefully read the GEOLITE2_LICENSE and GEOLITE2_EULA files, if you use these database. This package comes with certain restrictions and obligations, most notably:

  • You cannot prevent the library from updating the databases.
  • You cannot use the GeoLite2 data:
    • for FCRA purposes,
    • to identify specific households or individuals.

You can read the latest version of GeoLite2 EULA. GeoLite2 databse is provided under CC BY-SA 4.0 by MaxMind, so, you must create attribution to MaxMind for using GeoLite2 database. If you need better accuracy, please use the commercial version GeoIp2.

changelog

Changelog

We could not keep the git histories because of the github limitation as #4.
Therefore, instead of git history, please refer to this CHANGELOG.

  • 2025-04-08: Added iplocate-country and iplocate-asn database #45
  • 2024-10-05: Added new geofeed providers (about 200)
  • 2024-09-13: Fixed country codes of geofeed providers which added at 2024-09-10 ZN, UK, FL #36 (geo-asn-country and geo-whois-asn-country)
  • 2024-09-10: Added new geofeed providers (about 1500)
  • 2024-08-20: Added geolite2-geo-whois-asn-country and dbip-geo-whois-asn-country
  • 2024-08-20: Added links to mmdb files to main readme #34
  • 2024-08-14: Added generation of mmdb files #34
  • 2023-05-17: Fixed overlapping ip ranges #17
  • 2023-02-23: Added asn types: asn, iptoasn-asn, dbip-asn, geolite2-asn #14
  • 2022-07-19: Added 7z compression type for city database #9