IPinfo - Comprehensive IP address data, IP geolocation API and database

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

API Schema
JSON
{
  "$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"
    }
  }
}
FieldDescriptionExample
ipThe IPv4 or IPv6 address associated with a residential proxy.175.107.211.204
last_seenThe last recorded date when the residential proxy IP was active, formatted as YYYY-MM-DD (ISO-8601). The timezone is UTC.2025-06-24
percent_days_seenThe percentage of days the IP was active in the last 7-day period, reflecting its activity and frequency within a residential proxy pool.14
serviceThe 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).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

Lookup IP addresses:

Bash
curl https://ipinfo.io/resproxy/175.107.211.204?token=$TOKEN
JSON
{
  "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.

Was this page helpful?