Overseas Rotating Residential Proxy

Overview

⚠️ Usage restriction: this proxy can only be used from networks outside mainland China (Hong Kong, Macau and Taiwan included). Direct access from mainland China is not available.

Protocols: both HTTP proxy and SOCKS5 proxy are supported, and both use the same authentication format.

🔑 How it works

authentication methods are available: username & password mode

Username & password mode: region, city and session duration are embedded in the authentication username, which gives the most flexibility and fine-grained control.

💡 Recommendation: username & password mode is strongly recommended.

Method 1: Username & password mode (recommended)

Authentication is done by embedding parameters in the username. It is the most flexible option and is strongly recommended.

1. Regional entry points

Region	Host	Protocols	Port
Americas	`us.proxyips.org`	HTTP/HTTPS/SOCKS5	7878
Europe	`eu.proxyips.org`	HTTP/HTTPS/SOCKS5	7878
Asia	`as.proxyips.org`	HTTP/HTTPS/SOCKS5	7878

Note: SOCKS5 works the same way as HTTP — just change the scheme from http:// to socks5://.

Which entry point should I use?

Pick the entry point for the continent where most of your target audience is located.
If you are unsure, use us.proxyips.org by default (widest node coverage).
All three entry points use the same authentication format, so switching is just a matter of changing the host.

2. Authentication username format

Username: [account]_custom_zone_[region code]:[password]
Password: [password]

3. Parameter reference

3.1 zone — target country/region (required)

If omitted, the request uses global random mixing.

Format: _custom_zone_[country code]

Common country codes:

Country	Code	Example
United States	US	`_custom_zone_US`
Japan	JP	`_custom_zone_JP`
United Kingdom	GB	`_custom_zone_GB`
South Korea	KR	`_custom_zone_KR`
Brazil	BR	`_custom_zone_BR`
Germany	DE	`_custom_zone_DE`
France	FR	`_custom_zone_FR`
Canada	CA	`_custom_zone_CA`
Australia	AU	`_custom_zone_AU`
India	IN	`_custom_zone_IN`

Full example:

Username: your_account_custom_zone_KR:your_password
Password: your_password

curl test:

curl -x us.proxyips.org:7878 -U "your_account_custom_zone_KR:your_password" http://ipinfo.io

3.2 st — target state/province (optional)

Some countries (e.g. the United States) support state-level targeting.

Format: _custom_zone_[country code]_st_[state name]

Common US states:

State	Value
California	California
Florida	Florida
Oregon	Oregon
Texas	Texas
New York	New_York

Note: replace spaces in state names with an underscore _.

Full example:

Username: your_account_custom_zone_US_st_California:your_password

curl test:

curl -x us.proxyips.org:7878 -U "your_account_custom_zone_US_st_California:your_password" http://ipinfo.io

3.3 city — target city (optional)

Further narrows the location to a specific city on top of the state.

Format: _custom_zone_[country code]_st_[state name]_city_[city name]

Full example:

Username: your_account_custom_zone_US_st_Mississippi_city_Jackson:your_password

curl test:

curl -x us.proxyips.org:7878 -U "your_account_custom_zone_US_st_Mississippi_city_Jackson:your_password" http://ipinfo.io

3.4 sid — sticky exit IP (optional)

Pass an 8-digit random number to keep using the same exit IP.

Format: _custom_zone_[region]_sid_[8 digits]

Full example:

Username: your_account_custom_zone_global_sid_14675113:your_password

curl test:

# Global random, sticky to one exit IP
curl -x us.proxyips.org:7878 -U "your_account_custom_zone_global_sid_14675113:your_password" http://ipinfo.io

Note: without the time parameter, how long the sticky IP lasts depends on your plan.

3.5 time — session duration (optional)

Used together with sid to set the maximum lifetime of the sticky IP, up to 180 minutes.

Format: _custom_zone_[region]_sid_[8 digits]_time_[minutes]

Available values: time_5, time_10, time_20, time_30, time_60, time_180, etc.

Full example:

Username: your_account_custom_zone_global_sid_14675113_time_20:your_password

curl test:

# Global random, sticky exit, alive for 20 minutes
curl -x us.proxyips.org:7878 -U "your_account_custom_zone_global_sid_14675113_time_20:your_password" http://ipinfo.io

4. Parameter combinations

Scenario	Username format
Country only	`account123_custom_zone_JP:mypassword`
Country + state	`account123_custom_zone_US_st_Florida:mypassword`
Country + state + city	`account123_custom_zone_US_st_Mississippi_city_Jackson:mypassword`
Sticky IP (global random)	`account123_custom_zone_global_sid_12345678:mypassword`
Sticky IP + duration	`account123_custom_zone_global_sid_12345678_time_30:mypassword`
Country + sticky IP + duration	`account123_custom_zone_KR_sid_87654321_time_60:mypassword`

The password in all examples above is mypassword.

5. Code examples

5.1 curl (command line)

# HTTP proxy
curl -x us.proxyips.org:7878 -U "account_custom_zone_JP:password" http://ipinfo.io

# SOCKS5 proxy
curl --socks5 us.proxyips.org:7878 -U "account_custom_zone_JP:password" http://ipinfo.io

5.2 Python (requests)

import requests

proxies = {
    'http': 'http://account_custom_zone_JP:password@us.proxyips.org:7878',
    'https': 'http://account_custom_zone_JP:password@us.proxyips.org:7878',
}

resp = requests.get('http://ipinfo.io', proxies=proxies, timeout=10)
print(resp.text)

5.3 Go (net/http)

package main

import (
    "net/http"
    "net/url"
)

func main() {
    proxyURL, _ := url.Parse("http://us.proxyips.org:7878")

    transport := &http.Transport{
        Proxy: http.ProxyURL(proxyURL),
    }

    client := &http.Client{
        Transport: transport,
    }

    req, _ := http.NewRequest("GET", "http://ipinfo.io", nil)
    req.SetBasicAuth("account_custom_zone_JP", "password")

    resp, err := client.Do(req)
    // handle the response...
}

5.4 Java (OkHttp)

OkHttpClient client = new OkHttpClient.Builder()
    .proxy(new Proxy(Proxy.Type.HTTP,
        new InetSocketAddress("us.proxyips.org", 7878)))
    .proxyAuthenticator((route, response) -> {
        String credential = Credentials.basic(
            "account_custom_zone_JP",
            "password"
        );
        return response.request().newBuilder()
            .header("Proxy-Authorization", credential)
            .build();
    })
    .build();

6. Notes

Region codes follow ISO 3166-1 alpha-2 (two uppercase letters).
State/city names: replace spaces with an underscore _.
sid must be exactly 8 digits.
time cannot exceed 180 minutes.
Global mixing: leaving out the zone parameter is allowed, but explicitly specifying a region is recommended.
Password must be supplied in both the username and the password field (the username format is account_params:password).

Overseas Rotating Residential Proxy – User Guide

Overview

🔑 How it works

Method 1: Username & password mode (recommended)

1. Regional entry points

2. Authentication username format

3. Parameter reference

3.1 zone — target country/region (required)

3.2 st — target state/province (optional)

3.3 city — target city (optional)

3.4 sid — sticky exit IP (optional)

3.5 time — session duration (optional)

4. Parameter combinations

5. Code examples

5.1 curl (command line)

5.2 Python (requests)

5.3 Go (net/http)

5.4 Java (OkHttp)

6. Notes