Username, ports and parameters

1. Address and ports

All Prokso proxies run through a single gateway, gw.prokso.com. The port decides what you get:

A sticky port keeps its address for as long as set in the "Session duration, minutes" field: from 1 to 120 minutes, 30 by default. The field is in the "Pool settings" block on the plan page. When the time runs out, the same port gets a new address. One port means one concurrent address: for ten accounts, take ten ports, for example 10000-10009.

Sites on https:// work through the HTTP port too: your software opens a tunnel through the proxy (the CONNECT method), and encryption runs from it to the site unchanged. In the proxy address itself, write http://, not https://.

2. String formats

The generator in the dashboard gives you the string in whatever form your software needs. The same four parts (host, port, username and password) in a different order:

Antidetect browsers mostly accept host:port:username:password, while libraries and curl take an address with the protocol. To convert a ready list from one format to another, use the converter.

3. Parameters in the username

Country, city or carrier are set right in the username: add two underscores after the username, then parameters separated by semicolons, USERNAME__parameter.value;parameter.value. The password stays the same.

Country targeting costs nothing extra. State, city, ZIP, carrier and exclusions are precise geo: that traffic counts double, so 1 GB uses 2 GB of your package. Precise geo works only together with a single country, with up to 10 values per field. Without parameters, the gateway gives an address from any available country.

Codes for cities, regions and carriers are suggested by the generator in the dashboard in advanced mode; pages for individual carriers are in the Providers section.

4. Ready-made examples

Fill in your own username and password from the plan page:

We don't guarantee that addresses for a specific city or carrier are available: the pool is live. If no address matches the parameters, the gateway returns a 503 NO_RAY error. Widen your selection, for example by removing the city.

5. IP whitelist without a password

If your software can't pass a username and password, add your computer's or server's IP to the "IP whitelist (no password)" block on the plan page, up to 5 addresses per plan. The string then consists of just the host and port: gw.prokso.com:10000.

Without a username there's no way to pass parameters, so set the countries in "Pool settings", in the "Default countries" field. City and carrier can't be set in this mode. More in the glossary: IP whitelist.

6. Check the result

The address https://prokso.com/ip returns the IP the request came from and what the geo database knows about it: country, region, city and carrier. A request through the proxy shows which address you got:

curl -x http://USERNAME__cr.pl:PASSWORD@gw.prokso.com:10000 https://prokso.com/ip

The response looks like this (values here are examples):

{"ip": "203.0.113.24", "country": "PL", "region": "Mazovia", "city": "Warsaw", "asn": 39603, "org": "P4 Sp. z o.o."}

For SOCKS5, write socks5h:// instead of socks5://: then the proxy, not your computer, resolves the site name to an address, and your DNS server doesn't see where you go. The country may differ between geo databases; we explain why in the glossary: IP geolocation. If you get an error instead of a response, go through the step-by-step check.

Proxy not working: check →How to use Prokso