Every Tor node, rebuilt every day.

Published as CSVGZ and MMDB. Every column is described in the docs.

One call gets you the current Tor IP build. Every official client wraps it three ways: straight to disk, a time-limited link you hand to your own runner, or bytes in memory. A file written to disk lands only once the whole transfer has arrived, and checksums() returns the published digests to verify it against.

download()

Streams the current build to a file, which lands only once the whole transfer has arrived, so a failed one never leaves a truncated file behind.

downloadUrl()

The time-limited link the API redirects to, for your own downloader, a job runner or a CDN pull.

downloadBytes()

The build in memory, for a small dataset or a pipeline that never touches a filesystem.

metadata()

Row count, file sizes and when the build last updated. Poll it and fetch only when a new one has landed.

checksums()

The md5, sha1, sha256 and sha512 digests of one file, to verify it once it lands.

PythonNode.jsGoPHPJavacURL

import os
from vpndetection import VPNDetection
 
client = VPNDetection(os.environ["VPNDETECTION_API_KEY"])
 
# to disk, streamed
client.database.download("tor_ip_v1", "csvgz", "tor_ip_v1.csv.gz")
# a time-limited link
url = client.database.download_url("tor_ip_v1", "csvgz")
# in memory
raw = client.database.download_bytes("tor_ip_v1", "csvgz")

download.pypip install vpndetection

Also available for .NET, Ruby, Rust, Swift, Erlang, Perl and Zig. See all on GitHub →

What it's used for

Three decisions Tor IP is bought for, and what each needs from the data rather than from a score.