Configuration

Password Parameters

Residential proxy behavior is controlled by appending parameters to your password. The format is:

1USERNAME:[email protected]:1111

Parameters are appended to the password with underscores. Order does not matter.

Geo-Targeting

Target specific locations by appending geographic parameters to your password.

Country Targeting

Use the ISO 3166-1 alpha-2 country code:

1# Target United States
2curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip
3
4# Target Germany
5curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip

City Targeting

Target a specific city within a country:

1# Target New York, US
2curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip

City names use underscores for spaces (e.g., los_angeles, new_york, sao_paulo).

Region/State Targeting

Target a region or state:

1# Target California, US
2curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip

Continent Targeting

Target an entire continent:

1# Target Europe
2curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip

Available continents: africa, asia, europe, north_america, south_america, oceania.

Sticky Sessions

Sticky sessions let you maintain the same IP address across multiple requests. This is useful for multi-step workflows like login flows, checkout processes, or maintaining session state.

Creating a Sticky Session

Add a session parameter with any unique ID:

1# All requests with this session ID use the same IP
2curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip

Session Duration

By default, sticky sessions last until the IP becomes unavailable. You can set a maximum duration (in minutes, up to 1440):

1# Sticky session lasting up to 60 minutes
2curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip

Combining with Geo-Targeting

1# Sticky session from Germany
2curl -x http://USERNAME:[email protected]:1111 https://httpbin.org/ip

IP Rotation

Without a session parameter, each request automatically gets a new IP address. This is the default behavior and is ideal for scraping where you want maximum IP diversity.

For concurrent connections, each connection gets a different IP from the pool automatically.

Expert Settings

Ad Blocking

Block ads and trackers at the proxy level to reduce bandwidth usage and speed up requests:

1curl -x http://USERNAME:PASSWORD_adblock-true@residential.proxyon.io:1111 https://example.com

Fraud Score Filtering

Filter out IPs with high fraud scores. Lower fraud scores mean cleaner, more trusted IPs:

1# Only use IPs with fraud score below 50
2curl -x http://USERNAME:[email protected]:1111 https://example.com

Device Filtering

Target specific device types for more natural-looking traffic:

1curl -x http://USERNAME:[email protected]:1111 https://example.com

HTTP3/QUIC Support

Enable HTTP3/QUIC protocol for lower latency connections:

1curl -x http://USERNAME:PASSWORD_http3-true@residential.proxyon.io:1111 https://example.com

UDP Support

Enable UDP protocol support:

1curl -x http://USERNAME:PASSWORD_udp-true@residential.proxyon.io:1111 https://example.com

Local DNS Resolution

Resolve DNS queries locally at the proxy endpoint for more accurate geo-located results:

1curl -x http://USERNAME:PASSWORD_localdns-true@residential.proxyon.io:1111 https://example.com

Subuser Mode

When ordering residential bandwidth via the API, you can set resold=true to create a subuser. This creates isolated credentials that can be shared with clients or team members without exposing your main account.

Parameter Reference