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 Sep 7, 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.129)

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 Sep 7, 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.124.tar.gz (447.3 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.124-cp310-abi3-win_amd64.whl (521.2 kB view details)

Uploaded CPython 3.10+Windows x86-64

iptocc-3.3.124-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (630.9 kB view details)

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

iptocc-3.3.124-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (631.0 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ ARM64

iptocc-3.3.124-cp310-abi3-macosx_11_0_arm64.whl (620.4 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

iptocc-3.3.124-cp310-abi3-macosx_10_12_x86_64.whl (619.8 kB view details)

Uploaded CPython 3.10+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: iptocc-3.3.124.tar.gz
  • Upload date:
  • Size: 447.3 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.124.tar.gz
Algorithm Hash digest
SHA256 06c99a2472eaf60105a327f40da760f965bdd2991ef22582a4770d4bdf7fc9f3
MD5 4e75136459832093d370016fb6a0fb45
BLAKE2b-256 459e63a20e167e0531f49a27c0d52d454ffefe88c1794add1ef43705b1fb03b9

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: iptocc-3.3.124-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 521.2 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.124-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 716bbdfb3da98812928b99cf2e55b5daee9cfdcf22b105416efcb4b8967db705
MD5 59fb40f6b13b97ec09ef184570e1290f
BLAKE2b-256 bdb1f0b40f6bcf8bc5ad0a2d970ef12e03e1466c044e9d1394eecc32dca0a691

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for iptocc-3.3.124-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 4b275f740c47aff327ad6a09752c552b0ccb38c379ed186ac785de9ffc285bdd
MD5 ddd4d2b79e568dc6ea34d42182f63d12
BLAKE2b-256 0bbe151e69d6415632f654a34322b0b6c9397f5ea7f000deae97ca48f514293a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for iptocc-3.3.124-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 903fd98479f80fed453fc0e2bbcc4c067e217866a13eb3e0340a6d6504eab56b
MD5 a7db2fc679a546f4c8eca45c496a2370
BLAKE2b-256 9204a07ab50d6bbcfd911fc39424788a244f331b2b20b483281116ba8de6f964

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for iptocc-3.3.124-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2b5aa8ebdc696f9f3c2a15cbb4c75b6cf72fc78ea966757dfbbd11dc3eb9be1d
MD5 6e6f3d4a8ccd56347f06eea1f61f39e1
BLAKE2b-256 d87021aaea98b701ecb2dc5368d282e97657d549cd192e68a6eeb444a9b33ad1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for iptocc-3.3.124-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 164fbacadfac48155cb9d504ddacc58bd035573162ba49b77271dab281514ca0
MD5 13464d70d1d8c1a631a964337f3b22fa
BLAKE2b-256 331099e7d14a42508d905f45acd392abee815d5d47269a03ccd06d66c1b8bc4f

See more details on using hashes here.

Provenance

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

6 files

3.3.128

6 files

3.3.127

6 files

3.3.126

6 files

3.3.125

6 files

This release

3.3.124 This release

6 files

3.3.123

6 files

3.3.122

6 files

3.3.121

6 files

3.3.120

6 files

3.3.119

6 files

3.3.118

6 files

3.3.117

6 files

3.3.116

6 files

3.3.115

6 files

3.3.114

6 files

3.3.113

6 files

3.3.112

6 files

3.3.111

6 files

3.3.110

6 files

3.3.109

6 files

3.3.108

6 files

3.3.107

6 files

3.3.106

6 files

3.3.105

6 files

3.3.104

6 files

3.3.103

6 files

3.3.102

6 files

3.3.101

6 files

3.3.100

6 files

3.3.99

6 files

3.3.98

6 files

3.3.97

6 files

3.3.96

6 files

3.3.95

6 files

3.3.94

6 files

3.3.93

6 files

3.3.92

6 files

3.3.91

6 files

3.3.90

6 files

3.3.89

6 files

3.3.88

6 files

3.3.87

6 files

3.3.86

6 files

3.3.85

6 files

3.3.84

6 files

3.3.83

6 files

3.3.82

6 files

3.3.81

6 files

3.3.80

6 files

3.3.78

6 files

3.3.77

6 files

3.3.76

6 files

3.3.75

6 files

3.3.74

6 files

3.3.73

6 files

3.3.72

6 files

3.3.71

6 files

3.3.70

6 files

3.3.69

6 files

3.3.68

6 files

3.3.67

6 files

3.3.66

6 files

3.3.65

6 files

3.3.64

6 files

3.3.63

6 files

3.3.62

6 files

3.3.61

6 files

3.3.60

6 files

3.3.59

6 files

3.3.58

6 files

3.3.57

6 files

3.3.56

6 files

3.3.55

6 files

3.3.54

6 files

3.3.53

6 files

3.3.52

6 files

3.3.51

6 files

3.3.50

6 files

3.3.49

6 files

3.3.48

6 files

3.3.47

6 files

3.3.46

6 files

3.3.45

6 files

3.3.44

6 files

3.3.43

6 files

3.3.42

6 files

3.3.41

6 files

3.3.40

6 files

3.3.39

6 files

3.3.38

6 files

3.3.37

6 files

3.3.36

6 files

3.3.35

6 files

3.3.34

6 files

3.3.33

6 files

3.3.32

6 files

3.3.31

6 files

3.3.30

6 files

3.3.29

6 files

3.3.28

6 files

3.3.27

6 files

3.3.26

6 files

3.3.25

6 files

3.3.24

6 files

3.3.23

6 files

3.3.22

6 files

3.3.21

6 files

3.3.20

6 files

3.3.19

6 files

3.3.18

6 files

3.3.17

6 files

3.3.16

6 files

3.3.15

6 files

3.3.14

6 files

3.3.13

6 files

3.3.12

6 files

3.3.11

6 files

3.3.10

6 files

3.3.9

6 files

3.3.8

6 files

3.3.7

6 files

3.3.6

6 files

3.3.5

6 files

3.3.4

6 files

3.3.3

6 files

3.3.2

6 files

3.3.1

6 files

3.3.0

6 files

3.2.3

6 files

3.2.2

6 files

3.2.1

6 files

3.2.0

6 files

3.1.2

6 files

3.1.1

6 files

3.1.0

6 files

3.0.0

6 files

Pre-release

3.0.0a1

6 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.1

2 files

2.0.0

3 files

1.1.2

1 file

Pre-release

1.1.1a0

1 file

1.0.8

1 file

1.0.7

1 file

1.0.6

1 file

1.0.5

1 file

1.0.4

1 file

1.0.3

1 file

1.0.2

1 file

1.0.1

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page