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 |
| 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?