Skip to main content

Privacy Detection API (Standard)

Offered as a customized API service, available only to enterprise customers.

The IPinfo IP to Privacy Detection (Standard) API provides detection of anonymous IP addresses, identifying whether an IP is associated with a VPN, proxy, Tor network, relay service, or hosting provider. IPinfo uses multi-modal detection methods to detect anonymous IP addresses, which includes internet measurement, IP address behavior and characteristics, internet records metadata, etc.

Privacy detection data is available through self-serve options directly as well.

Self-Serve TierCoverage
IPinfo Core (limited)Privacy/anonymous IP data via IP connection type flags
IPinfo PlusFull privacy detection data
IPinfo MaxFull privacy detection data plus residential proxy data

If you're not an existing Custom API user, we recommend starting with one of our self-serve API tiers above — no enterprise contract required.

Quick Reference

API Schema
JSON
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "IPinfo IP to Privacy Detection (Standard) API Response",
  "description": "Schema for IPinfo IP to Privacy Detection (Standard) API response",
  "type": "object",
  "properties": {
    "vpn": {
      "type": "boolean",
      "description": "Indicates Virtual Private Network (VPN) service exit node IP address.",
      "example": true
    },
    "proxy": {
      "type": "boolean",
      "description": "Indicates an open web proxy IP address.",
      "example": false
    },
    "tor": {
      "type": "boolean",
      "description": "Indicates whether the IP address is a Tor exit node.",
      "example": false
    },
    "relay": {
      "type": "boolean",
      "description": "Indicates a location-preserving anonymous relay service.",
      "example": false
    },
    "hosting": {
      "type": "boolean",
      "description": "Indicates a hosting/cloud service/data center IP address.",
      "example": true
    },
    "service": {
      "type": "string",
      "description": "Name of the privacy service provider - includes VPN, Proxy, and Relay service provider names.",
      "example": "NordVPN"
    }
  }
}
FieldDescriptionExample
vpnIndicates Virtual Private Network (VPN) service exit node IP addresstrue
proxyIndicates an open web proxy IP addressfalse
torIndicates whether the IP address is a Tor exit node.false
relayIndicates a location-preserving anonymous relay servicefalse
hostingIndicates a hosting/cloud service/data center IP addresstrue
serviceName of the privacy service provider - includes VPN, Proxy, and Relay service provider namesNordVPN

Lookup IP addresses

Bash
curl https://ipinfo.io/193.42.96.221/privacy?token=$TOKEN
JSON
{
  "vpn": true,
  "proxy": false,
  "tor": false,
  "relay": false,
  "hosting": true,
  "service": "NordVPN"
}

In the case that the IP address is not an anonymous type or actively hosting IP anonymization technology (only a hosting-type IP), the respective detection metadata fields will not be present.

non-anonymous IP address
Bash
curl https://ipinfo.io/93.42.96.221/privacy?token=$TOKEN
JSON
{
  "vpn": false,
  "proxy": false,
  "tor": false,
  "relay": false,
  "hosting": false,
  "service": ""
}
Hosting (only) type IP address
Bash
curl https://ipinfo.io/2a02:6ea0:2700:1:1012:2a00:4028:0/privacy?token=$TOKEN
JSON
{
  "vpn": false,
  "proxy": false,
  "tor": false,
  "relay": false,
  "hosting": true,
  "service": ""
}

If you are using an IPv6 connection, please use the v6.ipinfo.io endpoint.

Was this page helpful?