View Categories

Connection reference: hosts, ports and username parameters

Every host, port and username parameter in one place. Each proxy type has its own username and password, shown on its page in your dashboard; USERNAME and PASSWORD stand for them below.

Gateways

Proxy type Host and port Protocols
Rotating Residential v2.proxyempire.io:5000 HTTP, HTTPS, SOCKS5, UDP
Rotating Mobile v2.proxyempire.io:5000 HTTP, HTTPS, SOCKS5, UDP
Rotating Datacenter datacenter.proxyempire.io:9000 HTTP, HTTPS, SOCKS5
ISP Proxies (Static Residential) static.proxyempire.io:9000 HTTP, HTTPS, SOCKS5
Unlimited Residential unlimited.proxyempire.io:5000 HTTP, HTTPS, SOCKS5
Dedicated Mobile mobdedi.proxyempire.io:9000 HTTP, HTTPS, SOCKS5

All proxies use username and password authentication, and there is no IP whitelisting. The login differs per proxy type: residential usernames start with r_ and mobile usernames with m_, for example. HTTP and SOCKS5 share the same host, port and login on every type, so only the scheme changes: http://, socks5:// (DNS on your machine) or socks5h:// (DNS at the proxy). UDP details are in connection protocols.

Proxy string formats

Different tools expect the same four values in a different order. The Proxy Manager’s proxy list and the API can output all three:

USERNAME:PASSWORD@v2.proxyempire.io:5000
v2.proxyempire.io:5000:USERNAME:PASSWORD
http://USERNAME:PASSWORD@v2.proxyempire.io:5000

Username parameters

On Rotating Residential and Rotating Mobile, targeting and session settings are added to the username. Add them in the order of this table and leave out the ones you don’t need:

USERNAME-country-us-region-california-city-los+angeles-sid-a1b2c3d4
Parameter Sets Example
-country- Country code -country-us
-region- State or region -region-california
-city- City, with + for spaces -city-los+angeles
-isp- ISP, or the carrier on mobile -isp-at&t+internet
-asn- Network number, digits only. It sets the country by itself -asn-7922
-zip- ZIP or postal code. It needs a country and matches that code or a nearby one -zip-90210
-os- OS fingerprint: windows, macos, linux or android -os-windows
-sid- Sticky session ID: 8 letters or digits -sid-a1b2c3d4
-ttl- Session timer in minutes, after -sid- -ttl-30m

The Connection Builder lists the regions, cities, ZIP codes, ISPs and ASNs that have IPs online and writes the username for you, so copying from there is the safest route. The API lists the same values. Very narrow targeting, such as one ISP in a small city, means fewer available IPs. All targeting is included at no extra charge.

Sessions and rotation

Mode In the username What happens
Every request No -sid- Each new connection gets a different IP.
Same IP -sid-a1b2c3d4 The session keeps its IP until you rotate it or the device behind it goes offline. There is no fixed time limit.
Custom TTL -sid-a1b2c3d4-ttl-30m The IP changes on a timer you set, up to 2 hours (-ttl-120m). This is the longest an IP is kept, not the shortest.

Reuse a session ID to keep its IP, use a new ID to get a new IP, and give each parallel task its own ID. More in How to use sticky sessions.

Other proxy types

Rotating Datacenter

The country code comes straight after the username. Leave it out, or write any, for no country. Session parameters work as above. Targeting is by country only; use uk for the United Kingdom.

# A new IP in the United States on each request
USERNAME-us:PASSWORD@datacenter.proxyempire.io:9000
# One sticky IP, changed after 10 minutes
USERNAME-us-sid-12345678-ttl-10m:PASSWORD@datacenter.proxyempire.io:9000

ISP Proxies (Static Residential)

Each IP has one fixed string, shown on the ISP Proxies page in your dashboard. The username ends with the IP itself. The IP doesn’t change, so the username takes no targeting or session parameters. Buying, renewing and Auto Renew are covered in the ISP Proxies guide.

user_203.0.113.7:PASSWORD@static.proxyempire.io:9000

Unlimited Residential

Add -country- for a country and -sid- for a sticky session. Without a session ID, each request gets a new IP. Targeting is by country only. Plans, sessions and usage statistics are covered in the Unlimited Residential guide.

USERNAME-country-us-sid-a1b2c3d4:PASSWORD@unlimited.proxyempire.io:5000

Dedicated Mobile

Each device has its own username and password, shown in the device list on the Dedicated Mobile page. The username takes no parameters. To request a new IP, click Get New IP or open the device’s Change IP by link address. The link works without a login, from a browser or a script, so keep it private. Ordering a device and changing its location are covered in the Dedicated Mobile guide.

USERNAME:PASSWORD@mobdedi.proxyempire.io:9000

Open ports

Traffic Ports Status
TCP, all proxy types 80 and 443 Open by default
UDP, Rotating Residential and Rotating Mobile 443 and 53 Open by default
Other ports – On request, after KYC and a use-case review
Email 25 and other email ports Never opened

Some websites are blocked on all proxy types. See blocked websites and ports.

Examples

Put proxy strings in quotes in a shell, because ISP names can contain &.

# One sticky IP in Germany over SOCKS5
curl --proxy "socks5h://USERNAME-country-de-sid-a1b2c3d4:PASSWORD@v2.proxyempire.io:5000" https://ipinfo.io/json

# Windows fingerprint on Comcast's network (the ASN sets the country)
curl --proxy "http://USERNAME-asn-7922-os-windows:PASSWORD@v2.proxyempire.io:5000" https://ipinfo.io/json
# Playwright (Python) takes the parts separately
proxy = {"server": "http://v2.proxyempire.io:5000", "username": "USERNAME-country-us-sid-a1b2c3d4", "password": "PASSWORD"}

To build strings by code, use POST /proxy-list in the API, or ask the ProxyEmpire MCP server in Claude, ChatGPT or Cursor. Connection not working? See Why is my proxy not working?