Quickstart
How to buy, connect and test ProxyMaxy proxies. From payment to your first request takes a few minutes.
Getting started
Version: 2.0.0Last updated:
How to buy, connect and test ProxyMaxy proxies. From payment to your first request takes a few minutes.
If an order stays pending for a long time, check the payment status on the order page. If that does not help, contact support.
If you are not sure which type you need, start with a trial package of residential or mobile proxies.
| Type | Billing | Country | What you get |
|---|---|---|---|
| Residential | Per traffic, GB valid for 30 days | Country, region, city | An access string and IPs of home internet providers |
| Mobile | Per traffic, GB valid for 30 days | ||
| Unlimited | Per speed and term: 1, 7 or 30 days | ||
| Static | Per IP, 30 or 90 days |
An access string is made of the gateway host, a port, a username and a password. Your dashboard offers three formats: host:port:user:pass, user:pass@host:port and a ready-to-run curl command.
gw.proxymaxy.zspzvs.ru:1337:USERNAME:PASSWORDUSERNAME:PASSWORD@gw.proxymaxy.zspzvs.ru:1337curl -x http://USERNAME:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.ioEvery residential and mobile proxy uses one port: 1337. Your client picks HTTP or SOCKS5, and the port stays the same.
Residential and mobile proxies are configured through the login. It is assembled from parts: user-<your login>-network-<type>, then optionally -country-<country code> and -sid-<label>-ttl-<minutes>. The password stays the same.
| Login part | What it does |
|---|---|
| No suffix | Rotation: a new IP on every request, any country. |
| -country-<code> | An IP from the chosen country. A two-letter lower-case code: us, gb, de. |
| -sid-<label>-ttl-<minutes> | Sticky session: every request with the same label goes through one IP until the time runs out. The time is in minutes, up to 1440 (24 hours). |
curl -x http://user-USERNAME-network-eco:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.iocurl -x http://user-USERNAME-network-eco-country-gb:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.iocurl -x http://user-USERNAME-network-eco-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.iocurl -x http://user-USERNAME-network-eco-country-us-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.ioStatic proxies come as a list instead of a single string, one line per IP. The Copy list button copies every line at once, and Download all saves them to a .txt file.
203.0.113.10:PORT:PORT:USERNAME:PASSWORDStatic proxies have no shared gateway and no port 1337: the ports arrive in the issued list together with the IP, so use the values from your own line.
Unlimited is simpler: you get one fixed set of connection details. There is no country choice, and nothing to configure for rotation or sessions, so the login suffixes from the table above do not apply to unlimited.
Run the command in a terminal with the username and password from your dashboard (USERNAME and PASSWORD). The response should show the proxy IP and its country, not your home address. The examples below are for residential and mobile proxies.
curl -x http://user-USERNAME-network-eco:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.iocurl -x socks5h://user-USERNAME-network-eco:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.ioIf the command returns your real address or an error, see the connection errors section.
The mode is set in the login. In the dashboard the Rotation / Sticky session switch adds the right suffix for you: pick the session length (10 minutes, 30 minutes, 1, 4 or 24 hours), and the New IP button creates a fresh label. In scripts, append the suffix by hand: -sid-<label>-ttl-<minutes>, with the time from 0 to 1440 minutes (24 hours).
curl -x http://user-USERNAME-network-eco-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.ioRequests with the same session label go through one IP until the lifetime ends. A new label gives a new IP. Without a label every request gets a new IP. Unlimited and static proxies have neither mode.
In scripts the country is set by a username suffix: append -country- and a two-letter lower-case country code. Without the suffix the IP comes from any country. This applies to residential and mobile proxies.
curl -x http://user-USERNAME-network-eco-country-gb:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.iocurl -x http://user-USERNAME-network-eco-country-us-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.ioThe country code follows ISO 3166-1 alpha-2: us, gb, de, fr and so on. The list of available countries is shown in your dashboard.
| Code | Meaning | What to do |
|---|---|---|
| 407 | Wrong username or password | Copy the string from your dashboard again and check the username has no stray characters |
| 429 | Too many concurrent connections | |
| 502 | Could not reach the site through the IP | |
| 523 | All IPs in the chosen country are temporarily busy |
When your traffic runs out, the proxies stop responding. The remaining balance is shown in your dashboard, along with a Buy more traffic button.
| An access string and IPs of mobile carriers |
| A single access string, traffic is not metered |
| A list of IPs reserved for you |