IPToCC-Live

DEPRECATED: Use ip_to_country instead which is orders of magnitude faster!

Fork of https://github.com/roniemartinez/IPToCC that updates the databases regularly.

Get ISO country code of IPv4/IPv6 address. Address lookup is done locally.

Features

• No external API call
• No paid GeoIP service
• Thread-safe
• Offline
• Updated Nightly

To learn about using IP addresses for geolocation, read the Wikipedia article to gain a basic understanding.

Install

Install the latest version with the latest database...

pip install git+https://github.com/jamesdolan/IPToCC-Live.git@master

Usage

from iptocc import get_country_code
country_code = get_country_code('<IPv4/IPv6 address>')

Databases

• ftp://ftp.afrinic.net/stats/afrinic/delegated-afrinic-extended-latest
• ftp://ftp.arin.net/pub/stats/arin/delegated-arin-extended-latest
• ftp://ftp.apnic.net/public/apnic/stats/apnic/delegated-apnic-extended-latest
• ftp://ftp.lacnic.net/pub/stats/lacnic/delegated-lacnic-extended-latest
• ftp://ftp.ripe.net/pub/stats/ripencc/delegated-ripencc-extended-latest

Dependencies

• Python 3.9+
• pandas
• zstandard

References

• RIR Statistics Exchange Format
• How can I compile an IP address to country lookup database to make available for free?
• ISO 3166 Country Codes

Maintainers

• Ronie Martinez