Residential Proxy Detection API

The IPinfo Residential Proxy Detection API provides detailed insights into IP addresses associated with residential, mobile, or datacenter proxy networks, including activity patterns, and service identification.

You can access IPinfo IP to Residential Proxy Detection data as a downloadable dataset as well: IPinfo Residential Proxy Data Downloads

Quick Reference

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "IPinfo Residential Proxy Detection API Response",
  "description": "Schema for IPinfo Residential Proxy Detection API response",
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IPv4 or IPv6 address associated with a residential proxy.",
      "example": "175.107.211.204"
    },
    "last_seen": {
      "type": "string",
      "format": "date",
      "description": "The last recorded date when the residential proxy IP was active, formatted as YYYY-MM-DD (ISO-8601). The timezone is UTC.",
      "example": "2025-06-24"
    },
    "percent_days_seen": {
      "type": "integer",
      "description": "The percentage of days the IP was active in the last 7-day period, reflecting its activity and frequency within a residential proxy pool.",
      "minimum": 0,
      "maximum": 100,
      "example": 14
    },
    "service": {
      "type": "string",
      "description": "The name of the residential proxy service. Carrier/mobile services are suffixed with `_mobile` (e.g., `soax_mobile`) and datacenter services are suffixed with `_datacenter` (e.g., `brightdata_datacenter`).",
      "example": "ipfoxy"
    }
  }
}

Types of Proxies Detected

We currently recognize three types of residential proxies:

• Standard residential proxies: Residential proxy IP addresses
• Mobile/Carrier/Phone-based residential proxy IP addresses
• Datacenter-based residential proxy IP addresses

Time Windows

The Residential Proxy data is scoped to a time window — a rolling observation period that determines how far back an IP address's proxy activity is considered. The oldest last_seen date in the dataset will always fall within this period relative to today. This is not a fixed update cycle; the window moves continuously.

• The Residential Proxy API uses a 7-day observation period.
• The Residential Proxy Database download uses a 30-day observation period.

The percent_days_seen field reflects the percentage of days an IP was active within the observation period. For example, a percent_days_seen value of 50 on a 30-day dataset means the IP was seen as a proxy on approximately 15 of the last 30 days.

Lookup IP addresses:

curl https://ipinfo.io/resproxy/175.107.211.204?token=$TOKEN

{
  "ip": "175.107.211.204",
  "last_seen": "2025-06-24",
  "percent_days_seen": 14,
  "service": "ipfoxy"
}

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