Skip to main content
Our residential proxies give you IPs from real home connections around the world. You can target by country, state, city, ASN and operating system, keep the same IP with sessions, and send UDP over SOCKS5.
This is a developer guide. The quickest way to create proxies is the Residential dashboard.
Residential proxies overview

​
Proxy Format

​
Location Targeting

Only country is required. State and city are optional. The narrower the location, the fewer IPs are available.

​
Country

​
string
required
Name of the country you want to target.
Examples: country-UnitedStates, country-Israel, country-Hungary.

​
State or Region

​
string
State or region inside the selected country.
Examples:
  • state-northerndistrict (Israel)
  • state-pestcounty (Hungary)
  • state-california (United States)
  • state-newyork (United States)

​
City

​
string
City inside the selected state.
Examples:
  • city-maghar (Israel)
  • city-god (Hungary)
  • city-losangeles (United States)
  • city-newyork (United States)

​
Location Fallback

​
string
true to use another location in the same country when the exact state, city or ASN has no available IP.
By default, a location with no available IP returns PX1002. Add fallback-true to get another IP in the same country instead:
See Location Fallback.

​
Operating System

​
string
Operating system of the exit device: windows, mac, linux, android or ios.
Use it on its own or together with location targeting:
Examples: os-windows, os-android, country-UnitedStates-os-ios. See OS-Targeting.

​
Protocols

HTTP and HTTPS use port 5000. SOCKS5 uses port 5002 for sticky sessions and 5001 for rotating IPs. The username and password are the same on every port.

​
UDP

​
string
true to route the session over the UDP-capable path. SOCKS5 only.
UDP traffic such as DNS, QUIC, games and VoIP works over SOCKS5. Add udp-true to your username:
See UDP over SOCKS5.
Last modified on October 14, 2026