Skip to content

Latest commit

 

History

History

Privacy Detection

README.md

Privacy Detection

IP Addresses associated with identity hiding services such as VPN, Tor, Proxies, Relays and Hosting service.

Database Schema & Description

[data updated as of January, 2025]

Field Name Example Data Type Descrption
network 146.70.174.112/31 TEXT CIDR or single IP address of the IP address block
hosting true BOOLEAN Indicates a hosting/cloud service/data center IP address
proxy false BOOLEAN Indicates a open web proxy IP address
tor false BOOLEAN Indicates a TOR (The Onion Router) exit node IP address
relay false BOOLEAN Indicates Virtual Private Network (VPN) service exit node IP address
vpn true BOOLEAN Indicates location preserving anonymous relay service
service ProtonVPN TEXT Name of the anonymous IP service provider

Samples

Alternate Database Schema: standard_privacy

The standard_privacy data download is structured based on IP ranges (start_ip and end_ip) and includes the join_key column. Our default data downloads has been updated (January, 2025) to use the network-based schema which also does not include the join_key column. However, we will continue supporting the original IP range-based schema for existing customers, with no plans for deprecation. While the underlying data remains the same, the difference lies only in the schema.

Field Name Example Data Type Description
start_ip 89.187.171.147 TEXT Starting IP address of an IP address range
end_ip 89.187.171.147 TEXT Ending IP address of an IP address range
join_key 89.187.0.0 TEXT Special variable to facilitate databas join operation
hosting true BOOLEAN Indicates a hosting/cloud service/data center IP address
proxy BOOLEAN Indicates a open web proxy IP address
tor BOOLEAN Indicates a TOR (The Onion Router) exit node IP address
vpn true BOOLEAN Indicates Virtual Private Network (VPN) service exit node IP address
relay BOOLEAN Indicates location preserving anonymous relay service
service CyberGhost TEXT Name of the anonymous IP service provider

Includes IP range columns (start_ip and end_ip) instead of a network or CIDR based column (network). join_key represents the Class C network each IP address is part of, allowing you to filter the result set significantly before joining. Learn more about join_key here.

Samples

The schema for Boolean values is different between these two databases.

Boolean Value standard_privacy ipinfo_privacy
TRUE true true
FALSE false

Downloadable File Formats

  • CSV: Plain text file format where data is organized into rows, with individual values separated by commas.
  • JSON: More specifically, NDJSON (Newline Delimited JSON), a text file format where each line is a separated in valid JSON object.
  • MMDB: Specialized binary database for efficient and fast IP lookups.
  • Parquet: A columnar storage file format optimized for efficient data querying.

Please refer to "How to choose the best file format for your IPinfo database?" article to select the best format possible for your use case.

The usage of the IP data downloads relies on the software or application of the data. Check out our documentation, community, and our integrations pages to find the best path forward.

Filename references:

File Format Filename / Slug Terminal Command
CSV ipinfo_privacy.csv.gz curl -L https://ipinfo.io/data/ipinfo_privacy.csv.gz?token=$YOUR_TOKEN -o ipinfo_privacy.csv.gz
MMDB ipinfo_privacy.mmdb curl -L https://ipinfo.io/data/ipinfo_privacy.mmdb?token=$YOUR_TOKEN -o ipinfo_privacy.mmdb
JSON ipinfo_privacy.json.gz curl -L https://ipinfo.io/data/ipinfo_privacy.json.gz?token=$YOUR_TOKEN -o ipinfo_privacy.json.gz
Parquet ipinfo_privacy.parquet curl -L https://ipinfo.io/data/ipinfo_privacy.parquet?token=$YOUR_TOKEN -o ipinfo_privacy.parquet

API Response

As well as the database product, IPinfo also provides a robust API service. Please visit the IPinfo Documentation portal to learn more. The Privacy Detection API service is available as part of our Standard Tier plan.

API Query:

$ curl ipinfo.io/$IP_ADDRESS/carrier?token=TOKEN

Reponse:

{
    "vpn": true,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": false,
    "service": "NordVPN"
}

🔗 Privacy Data Documentation

privacy detection API response.png

API Samples

Guides, Resources & Links

Links

🔗 Privacy Detection Database Type

🔗 Privacy Detection Data Downloads Documentation

🔗 Privacy Detection API Page

🔗 Privacy Detection Data Type

Articles & Guides

FAQ (Frequently Asked Questions)

If you have any questions about using our data, feel free to ask us about it in the IPinfo Community.

Interested in more?

Currently, we are limiting the sample datasets to only 100 rows. If you would like to request a larger sample or would like to get a quote on the database products, feel free to reach to us.

Follow us on Twitter and LinkedIn to learn more about IP Address data and it’s fascinating potential.

About IPinfo

Founded in 2013, IPinfo prides itself on being the most reliable, accurate, and in-depth source of IP address data available anywhere. We process terabytes of data to produce our custom IP geolocation, company, carrier, VPN detection, hosted domains, and IP type data sets. Our API handles over 40 billion requests a month for 100,000 businesses and developers.

image