Proxy string format

Authentication is by login and password only; there is no IP allowlist. Your password is the same in every string, while the login changes with the settings. UDP is not supported, including over SOCKS5.

For how HTTP and SOCKS5 differ and which one to choose, see HTTP vs SOCKS5 proxy: which protocol to choose.

Parameters in square brackets are optional, and a vertical bar means “one or the other”. Hyphens separate the parameters:

Country is required. Region and city narrow the location down and can be used together or separately, so a string with country-us-city-miami is valid too.

After that, pick one of two: a provider (isp) or a ZIP code (zip). In the generator, this is the “Targeting” switch: “ISP” or “ZIP code”. For mobile proxies, the ISP field lists mobile carriers.

When a ZIP code is set, region and city are not written to the string, because the postal code sets the location. In the generator, they only narrow down the list of ZIP codes.

A string with sid is a sticky session. As long as you connect with the same unchanged string, the service keeps one exit IP for as long as possible, until the provider drops the connection. There is no duration setting and we don’t promise a specific length, so check the IP after reconnecting.

Every string in a batch gets its own sid, so each one is a separate session. If you need a different address, take another string or click “Regenerate”. A sid contains only lowercase Latin letters and digits, with no hyphens; the generator makes it 10 characters long. If you build strings yourself, use a new value for each new session.

A string without sid rotates: each new connection may get a new IP. Requests sent over one open connection (keep-alive) may come from the same address.

For when to use which mode, see Sticky session vs rotating proxies.

A mobile string differs from a residential one only by type-mobile. Both types draw on the same traffic balance. The ipv4-true parameter matches the “IPv4 only” switch.

The filter matches “Pool optimization” in the generator and always comes last in the login:

Any filter narrows the pool of available addresses. Without a filter parameter, a string uses the whole pool unfiltered, but neither the Dashboard nor the bot issues such strings. The gateway also accepts a stricter quality filter, filter-high (filter-high-speed-fast together with speed), which the generator does not offer.

Open “Generate proxies” in the Dashboard, choose a country, region, city, ISP or ZIP code and generate a string: the codes appear in the login. The lists of regions, cities, ISPs and ZIP codes depend on the proxy type and the “IPv4 only” switch, so a code that exists for residential proxies may be missing for mobile ones.

Strings from the @proxetabot Telegram bot also carry country, region and city codes: find a country or city with the search. The bot replies in Russian only and issues sticky sessions with the “Quality” filter only, without an ISP or ZIP choice.

Codes are written in lowercase Latin letters, with words joined by underscores: los_angeles, t_mobile_usa. If you build a string yourself, take codes only from generated strings: with an unknown code, an extra parameter or the wrong order, the gateway may reject the login or return an IP from the wrong location.

The Dashboard issues strings as host:port:login:password. Many programs want a URL instead: http://login:password@host:8080 for HTTP or socks5h://login:password@host:1080 for SOCKS5 (with socks5h, the proxy resolves site names rather than your device). For example:

If the password contains characters such as @, : or /, URL-encode them. Examples for curl are in curl with a proxy, and for Python and Playwright in Proxies in Python: requests, httpx and Playwright.

The parameters on this page apply only to residential and mobile proxies. ISP proxy details are fixed: the IP, port, login and password are listed in your order on the “My proxies” tab. You choose the country when you order; region, city, ISP, ZIP code and session can’t be set.