Socket
Socket
Sign inDemoInstall

@ip-location-db/dbip-city

Package Overview
Dependencies
0
Maintainers
1
Versions
51
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@ip-location-db/dbip-city

Ip to location database


Version published
Maintainers
1
Weekly downloads
686
increased by4.26%

Weekly downloads

Readme

Source

ip-location-db/dbip-city

DatabaseTypeLicenseUpdateipv4ipv6ipv4-numipv6-num
ASN
npm version
CountryCC0Dailyasn-country-ipv4.csvasn-country-ipv6.csvasn-country-ipv4-num.csvasn-country-ipv6-num.csv
GeoFeed + ASN
npm version
CountryCC0Dailygeo-asn-country-ipv4.csvgeo-asn-country-ipv6.csvgeo-asn-country-ipv4-num.csvgeo-asn-country-ipv6-num.csv
GeoFeed + Whois + ASN
npm version
CountryCC0Dailygeo-whois-asn-country-ipv4.csvgeo-whois-asn-country-ipv6.csvgeo-whois-asn-country-ipv4-num.csvgeo-whois-asn-country-ipv6-num.csv
RouteViews + ASN + DB-IP
npm version
ASNCC BY 4.0 by RouteViews and DB-IPDailyasn-ipv4.csvasn-ipv6.csvasn-ipv4-num.csvasn-ipv6-num.csv
IPtoASN
npm version
ASNPDDL by IPtoASNDailyiptoasn-asn-ipv4.csviptoasn-asn-ipv6.csviptoasn-asn-ipv4-num.csviptoasn-asn-ipv6-num.csv
IPtoASN
npm version
CountryPDDL by IPtoASNDailyiptoasn-country-ipv4.csviptoasn-country-ipv6.csviptoasn-country-ipv4-num.csviptoasn-country-ipv6-num.csv
DB-IP Lite
npm version
ASNCC BY 4.0
by DB-IP
Monthlydbip-asn-ipv4.csvdbip-asn-ipv6.csvdbip-asn-ipv4-num.csvdbip-asn-ipv6-num.csv
DB-IP Lite
npm version
CountryCC BY 4.0
by DB-IP
Monthlydbip-country-ipv4.csvdbip-country-ipv6.csvdbip-country-ipv4-num.csvdbip-country-ipv6-num.csv
DB-IP Lite
npm version
npm version
CityCC BY 4.0
by DB-IP
Monthlydbip-city-ipv4.csv.gz
dbip-city-ipv4.csv.7z
dbip-city-ipv6.csv.gz
dbip-city-ipv6.csv.7z
dbip-city-ipv4-num.csv.gz
dbip-city-ipv4-num.csv.7z
dbip-city-ipv6-num.csv.gz
dbip-city-ipv6-num.csv.7z
GeoLite2
npm version
ASNGeoLite2 License by MaxMindTwice weeklygeolite2-asn-ipv4.csvgeolite2-asn-ipv6.csvgeolite2-asn-ipv4-num.csvgeolite2-asn-ipv6-num.csv
GeoLite2
npm version
CountryGeoLite2 License by MaxMindTwice weeklygeolite2-country-ipv4.csvgeolite2-country-ipv6.csvgeolite2-country-ipv4-num.csvgeolite2-country-ipv6-num.csv
GeoLite2
npm version
npm version
CityGeoLite2 License by MaxMindTwice weeklygeolite2-city-ipv4.csv.gz
geolite2-city-ipv4.csv.7z
geolite2-city-ipv6.csv.gz
geolite2-city-ipv6.csv.7z
geolite2-city-ipv4-num.csv.gz
geolite2-city-ipv4-num.csv.7z
geolite2-city-ipv6-num.csv.gz
geolite2-city-ipv6-num.csv.7z

CSV format

This project provides ip to location database in csv format. If you need MMDB format, please use mmdbmeld.

ASN csv format

ip_range_start, ip_range_end, as_number, as_organization

Country csv format

ip_range_start, ip_range_end, country_code

City csv format

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

as_number

as_number is a unique number assigned to an Autonomous System (AS) by the IANA. wiki.

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.

ip address format

ip_range_start and ip_range_end is ip address.

  • ipv4: The csv line 1.0.0.0,1.0.0.255,AU means that ip addresses between 1.0.0.0 and 1.0.0.255 inclusive are AU country_code.
  • ipv4-num: The csv line 16777216,16777471,AU means that ip addresses between 1.0.0.0 and 1.0.0.255 inclusive are AU country_code. (16777216 is the number format of the ip address 1.0.0.0)
  • ipv6: The csv line 2001:200::,2001:200:ffff:ffff:ffff:ffff:ffff:ffff,JP means that ip addresses between 2001:200:: and 2001:200:ffff:ffff:ffff:ffff:ffff:ffff inclusive are JP country_code.
  • ipv6-num: The csv line 42540528726795050063891204319802818560,42540528806023212578155541913346768895,JP means that ip addresses between 2001:200:: and 2001:200:ffff:ffff:ffff:ffff:ffff:ffff inclusive are JP country_code. (42540528726795050063891204319802818560 is the number format of the ip address 2001:200::)

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

Databases referenced in this project

When merging multiple database, set the front database above back one. (ex. geo-whois-asn-...csv is created by merging 3 database with GeoFeed > Whois > ASN.)

ASN database [Update: Daily]

Created by merging 5 RIP (afrinic, apnic, arin, lacnic, ripe ncc) IP-ASN-Country database. ASN (Autonomous System Number) is a unique number assigned to an Autonomous System (AS) by the IANA.

GeoFeed database [Update: Daily]

Created by merging GeoFeed database from OpenGeoFeed.

Whois database [Update: Daily]

Created by merging 5 RIP provided WHOIS database. There are some inconsistencies between 5 RIP.

RouteViews database [Update: every 2 hours]

We are using this database to get AS number from ipv4 address for asn. This is licensed under a CC BY 4.0, so, you must create attribution to RouteViews for using asn database.

IPtoASN database [Update: Hourly]

You can download hourly updated database in tsv format from original site. This is licensed under a Public Domain Dedication and Licence v1.0. There are some differences from above ASN database.

DB-IP database [Update: Monthly]

You could download and read the license from ip-to-asn-lite or ip-to-country-lite or ip-to-city-lite. Most of the AS Organization name used in asn uses ip-to-asn-lite database. We also use ip-to-asn-lite to get AS Number from ip address as a supplemental.

These database are licensed under a CC BY 4.0, so, you must create attribution to DB-IP.com for using DB-IP database.
In the case of a web application, you must include a link back to DB-IP.com on pages that display or use results from the database. You may do it by pasting the HTML code snippet into your code: <a href='https://db-ip.com/'>IP Geolocation by DB-IP</a>.
If you need better accuracy or no attribution or daily updates, please use the Commercial Version of db-ip.

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.

Of course, it depends on your use case. But the above list is too long, thus, we write down the recommendation.

  • If you need postcode or timezone, geolite2-city is the one.
  • If you need city data with CC-BY License, dbip-city is the one.
  • If you need country database with Public Domain, we recommend geo-whois-asn-country database.
  • If you need asn database, we recommend asn database.

Libraries to use database

We can use libraries in many languages by using mmdb format. Some of them are distributed in HostByBelle/IP-Geolocation-DB and we can convert csv to mmdb by safing/mmdbmeld. For example, we can use maxmind developed libraries which are written in python, PHP, perl, ruby, .net, C, java, .net, and so on.

Tools & Applications

Here is a list of tools and applications that can work with these databases:

  • safing/mmdbmeld: Create and customize MMDB file from this database.
  • realchandan/Ip-geo-API: Go written HTTP server for IPv4 and IPv6 lookups.
  • EP-u-NW/ip_location_server: A GRPC and HTTP server mapping IP addresses to locations. Supports IPv4 and IPv6 and automatic dataset updates.
  • IPInfoOffline: Allows you to view information about IP addresses, without connecting any external server.

If you know some more, feel free to append it to the list and open a pull request.

License

License depends on the database which you use. Please read carefully each database license. You can use PDDL (ODC Public Domain Dedication and Licence) or CC0 (Creative Commons Zero) licensed database without attribution for any purpose.

We are glad if you make a link to sapics/ip-location-db, or give us a star to the github repository.

Keywords

FAQs

Last updated on 01 Mar 2024

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc