iptocc

PyPI Python License

Python bindings for the iptocc Rust crate. Offline IPv4 and IPv6 to ISO 3166-1 alpha-2 country code lookup.

Note: Country codes reflect the country assigned by a Regional Internet Registry (RIR) to each IP block, not where the block is being used. RIR data agrees with MaxMind for ~95% of IPv4 addresses and has minimal discrepancies for IPv6 (Zander, 2012).

Important: iptocc 3.0 is a complete Rust rewrite. Versions 2.x and earlier were pure Python on top of pandas. The public API stays mostly compatible (see migration notes below), single-lookup latency dropped from ~78 ms to ~44-141 ns, and a batch API was added.

Features

  • Offline lookup, no API keys, no network calls
  • IPv4 and IPv6 in one call
  • Single string OR batch (any iterable of strings)
  • Lookup data embedded in the wheel; no runtime file I/O
  • iptocc CLI installed with pip install iptocc
  • Data refreshed nightly from the five Regional Internet Registries

Install

Requires Python 3.10 or newer.

pip install iptocc

Usage

from iptocc import country_code

country_code("8.8.8.8")                       # "US"
country_code(["8.8.8.8", "1.0.16.1"])         # ["US", "JP"]

A CLI is installed alongside the library:

$ iptocc 8.8.8.8 1.0.16.1
8.8.8.8 US
1.0.16.1 JP

Migrating from 2.x

# 2.x
from iptocc import get_country_code, CountryCodeNotFound
try:
    cc = get_country_code("8.8.8.8")
except CountryCodeNotFound:
    cc = None

# 3.x
from iptocc import country_code
cc = country_code("8.8.8.8")  # returns None on miss

See also

Project links

Data verified by PyPI on Aug 9, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.3.103)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for roniemartinez from gravatar.com roniemartinez Avatar for ronmarti from gravatar.com ronmarti

Credits

Author: Ronie Martinez

GitHub Statistics

Data verified by PyPI on Aug 9, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT OR Apache-2.0
View SPDX License List

Requires

Python >=3.10

Tags

geoip country ip ipv4 ipv6 rust

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iptocc-3.3.98.tar.gz (446.4 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

iptocc-3.3.98-cp310-abi3-win_amd64.whl (516.4 kB view details)

Uploaded CPython 3.10+Windows x86-64

iptocc-3.3.98-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (629.1 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ x86-64

iptocc-3.3.98-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (627.9 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ ARM64

iptocc-3.3.98-cp310-abi3-macosx_11_0_arm64.whl (619.6 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

iptocc-3.3.98-cp310-abi3-macosx_10_12_x86_64.whl (618.8 kB view details)

Uploaded CPython 3.10+macOS 10.12+ x86-64

File details

Details for the file iptocc-3.3.98.tar.gz.

File metadata

  • Download URL: iptocc-3.3.98.tar.gz
  • Upload date:
  • Size: 446.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iptocc-3.3.98.tar.gz
Algorithm Hash digest
SHA256 5b86778b3f0989e8ec4ecb819e420626481aed7985a43aa66811f32f12476529
MD5 02ce2766fa36da6ee85dbe264c215995
BLAKE2b-256 b55a6320d99beb937b4a2b15a1bd6dd557ef26c7382aec9b25189eb591143341

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.98.tar.gz:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.98-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: iptocc-3.3.98-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 516.4 kB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iptocc-3.3.98-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 a6b7aa8624fd95e97e36baf6e27544129f4b384a2622fc3fef6b37b26947a5c5
MD5 bc3eb1c1cc0cdbc4e9760c1b253ee410
BLAKE2b-256 c594f41487b692cb62ba6547a01316027b73b20d0cc4941092339fe028ee5f72

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.98-cp310-abi3-win_amd64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.98-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.98-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 9df73e61106832e263370d3cb92b08e8e2a95cff42b53b5660213ad42063a70f
MD5 fc310e4b9e00bd8750e2ab329fdffb86
BLAKE2b-256 4cfe49f18713854f4aa55880b36bbdb41bdc988e3d03b3d628593e20aa5686cc

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.98-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.98-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.98-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 1e55972145ee542353ad83110a09e4c2da36bbbfb804b40fe82818a379b3f23d
MD5 48d419891a9710931b35c48adef6fe4e
BLAKE2b-256 e46d8d8197f547e0ef83b9e521ddc508239ee3e7ba02c3d6c1bd6dfdd5342a25

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.98-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.98-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.98-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3f88bfda5eb39c1abac53d57e8d657c36ad9d15454103e15a3b9ec3f64cb927b
MD5 f1c3cb791fdf987e8891717cf2f2e851
BLAKE2b-256 95febc35231b290c1d7f5dc6e5e16b9f208962c9314d78ab65402d803e95c6aa

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.98-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.98-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.98-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 1890f6c221d288911eaacf2d26decd2c44b1de6807302c6534469ddf755f6bce
MD5 90eb80ff2a01a243658ca455bdba1c8f
BLAKE2b-256 831cf10c3e212d8ab7dd1948bc94daf3184a3aa27038b1a85e128df4c6408385

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.98-cp310-abi3-macosx_10_12_x86_64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

3.3.103

3.3.102

3.3.101

3.3.100

3.3.99

This release

3.3.98

3.3.97

3.3.96

3.3.95

3.3.94

3.3.93

3.3.92

3.3.91

3.3.90

3.3.89

3.3.88

3.3.87

3.3.86

3.3.85

3.3.84

3.3.83

3.3.82

3.3.81

3.3.80

3.3.78

3.3.77

3.3.76

3.3.75

3.3.74

3.3.73

3.3.72

3.3.71

3.3.70

3.3.69

3.3.68

3.3.67

3.3.66

3.3.65

3.3.64

3.3.63

3.3.62

3.3.61

3.3.60

3.3.59

3.3.58

3.3.57

3.3.56

3.3.55

3.3.54

3.3.53

3.3.52

3.3.51

3.3.50

3.3.49

3.3.48

3.3.47

3.3.46

3.3.45

3.3.44

3.3.43

3.3.42

3.3.41

3.3.40

3.3.39

3.3.38

3.3.37

3.3.36

3.3.35

3.3.34

3.3.33

3.3.32

3.3.31

3.3.30

3.3.29

3.3.28

3.3.27

3.3.26

3.3.25

3.3.24

3.3.23

3.3.22

3.3.21

3.3.20

3.3.19

3.3.18

3.3.17

3.3.16

3.3.15

3.3.14

3.3.13

3.3.12

3.3.11

3.3.10

3.3.9

3.3.8

3.3.7

3.3.6

3.3.5

3.3.4

3.3.3

3.3.2

3.3.1

3.3.0

3.2.3

3.2.2

3.2.1

3.2.0

3.1.2

3.1.1

3.1.0

3.0.0

3.0.0a1 pre-release

2.1.2

2.1.1

2.1.0

2.0.1

2.0.0

1.1.2

1.1.1a0 pre-release

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page