@ip-location-db/iptoasn-country
v2.3.2026061719
Published
Ip to location database
Downloads
16,535
Maintainers
Readme
[!CAUTION] 🚨 CRITICAL NOTICE: Data Bugs & Migration
Please be aware that the current data published to
npmand themainbranch contains bugs resulting in incorrect data.To immediately resolve these data accuracy and compliance issues, updates via
npmare completely deprecated and will stop.The corrected data and new, compliant generation logic are already available in the
main-testbranch. We will be completely replacing themainbranch with this structure very soon.Action Required: We strongly urge all users to switch immediately to avoid using incorrect data. Please update your systems to download the latest data directly from our GitHub Releases.
ip-location-db/iptoasn-country
Download
| Database | Type | License | Updated | IPv4 | IPv6 | IPv4+IPV6 | IPv4-num | IPv6-num |
|---|---|---|---|---|---|---|---|---|
| IPtoASN | Country | PDDL by IPtoASN | Daily | CSVMMDB | CSVMMDB | — | CSV | CSV |
CSV Format
ip_range_start, ip_range_end, country_codeip_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
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 License v1.0.
There are some differences from above ASN database.
License
These files are subject to the Public Domain Dedication and license v1.0. You may use these databases without attribution for any purpose.
