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 15, 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:
Latest release

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 15, 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.103.tar.gz (446.6 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.103-cp310-abi3-win_amd64.whl (516.9 kB view details)

Uploaded CPython 3.10+Windows x86-64

iptocc-3.3.103-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (629.4 kB view details)

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

iptocc-3.3.103-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (628.4 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ ARM64

iptocc-3.3.103-cp310-abi3-macosx_11_0_arm64.whl (619.9 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

iptocc-3.3.103-cp310-abi3-macosx_10_12_x86_64.whl (619.2 kB view details)

Uploaded CPython 3.10+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: iptocc-3.3.103.tar.gz
  • Upload date:
  • Size: 446.6 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.103.tar.gz
Algorithm Hash digest
SHA256 1d6620d07c77aefd49020238208b9c88137e7cd6ff34b7903011bf54737f1ec0
MD5 ab5a75795cb285168c532a5b955913b3
BLAKE2b-256 78623ed3d1e4a083d19ef9a41a1cb92fe4eee45804ac75d9f4a79b1bf5c7cc85

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.103.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.103-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: iptocc-3.3.103-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 516.9 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.103-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 c4e836797fc90851a03415a956b762c3ce465b270a6ab2bada24b9c3b1bfc3ab
MD5 8ae633d2ef42dd1515e8dd71b4b1a597
BLAKE2b-256 7aa6a1e91a3bd054c7b5bdbbf6884b270d8342ccb0e435a665bbb688cd3fce95

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.103-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.103-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.103-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 4491ae05e33ef5f297a097f64cc25573b0dbc9c01b48af5b1f4d521d5dac0b88
MD5 9bc3b6dc73b6608e83bd5045576a75f8
BLAKE2b-256 36a3328d02b5f363eecab9e617bddf152608ae931dccf8f9b9a3405725927c0d

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.103-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.103-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.103-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 9c2f9e39c7e8ee708ee25c19f41c3d34e534ea3d949924ac06a0a2166209dbef
MD5 33675cc01f6e56b98761fbf7895cac8a
BLAKE2b-256 81349eb64c42f5280cc9d032855b25df9a45c63d0fff88c94ecef55dfc78f019

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.103-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.103-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.103-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ee04ae04fd795068f48645221906848cfaa405fb7895f97741574a8ce0a25780
MD5 48dace0cd7e7c2e1354e7e611f383458
BLAKE2b-256 10b1ec940b3bd67d30a08dbb59511356d82967762f477d7141761f16690a55ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.103-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.103-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.103-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 44aa8f9f2e3a9c847ff74addbab80c5a5ac5387f9220dfb763d75c12911b0dff
MD5 6dd5ac8141821048d19e1ad64348acf1
BLAKE2b-256 35d6ace2b4d461ee8d2c669ef548ad1c31660ea2315521a2d7d84cc7e4987453

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.103-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

This release

3.3.103

3.3.102

3.3.101

3.3.100

3.3.99

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