Copy protocol, host, port, and auth from the console, then put them in the client—do not guess a hostname or port. This page shows a first check with Python requests. String shapes: Proxy format. Protocol choice: HTTP / SOCKS5 setup. Step-by-step commands follow Docs EN quickstart.
ZTProxy sells rotating residential (per GB) and static residential (per IP·month). Every example uses fake placeholders—not production hosts. Lawful, authorized targets only. Not for mainland China.
What to have ready
- An order or extract entry in the console, with rotating or static already chosen (if not, read rotating vs static).
- The protocol, host, port, username, and password (or equivalent) the console returns.
- Python 3 and
requestsinstalled. - An HTTPS check URL you are allowed to call. Do not load-test sites you do not have rights to.
| Ready item | Source |
|---|---|
| Protocol, host, port, auth | Console values only (not the fake placeholders) |
| Python 3 and requests | Your local environment |
| Check URL | An HTTPS target you may access |
| Rotating or static order | Rotating vs static |
Placeholders (not production): host proxy.example.invalid, port 10000, user USER_EXAMPLE, password PASS_EXAMPLE_NOT_REAL.
requests with an HTTP proxy
HTTPS sites usually go through an HTTP proxy via CONNECT. Set both http and https keys in proxies to the same proxy URL, or some requests will leave from your own IP. Keep credentials in environment variables, not in git.
import os
from urllib.parse import quote
import requests
user = quote(os.environ["ZT_PROXY_USER"], safe="")
password = quote(os.environ["ZT_PROXY_PASS"], safe="")
# Host and port come from the console—not from these fake defaults
host = os.environ.get("ZT_PROXY_HOST", "proxy.example.invalid")
port = os.environ.get("ZT_PROXY_PORT", "10000")
proxy_url = f"http://{user}:{password}@{host}:{port}"
proxies = {"http": proxy_url, "https": proxy_url}
session = requests.Session()
session.trust_env = False # do not let HTTPS_PROXY override this
resp = session.get("https://example.com", proxies=proxies, timeout=(10, 30))
print(resp.status_code)Always set timeout. URL-encode the username and password if they contain @ or :. More string variants: Proxy format.
Optional: SOCKS5 and socks5h
Switch only if the console returns SOCKS5 and your client needs SOCKS. Install requests[socks] first. If the library supports socks5h://, DNS goes through the proxy, which helps the resolved address match the exit region; socks5:// may resolve on your machine first. Do not assume UDP is available; follow the console and docs.
# Example only: protocol and port must match the console
proxy_url = f"socks5h://{user}:{password}@{host}:{port}"
proxies = {"http": proxy_url, "https": proxy_url}Rotation, sessions, and sticky
requests.Session() reuses the connection to the gateway. That is not a static IP, and it is not automatically a console sticky parameter. To keep an exit for a window, use the session controls the console documents, and read sticky vs static. For a term-long fixed exit, buy static.
Common issues
| Symptom | Check first |
|---|---|
| 407 / auth failed | Username and password match the console; special characters are encoded |
| Hang / timeout | Protocol and port match the order; you are not using the fake host |
| HTTPS still shows your IP | Both http and https keys are set; env vars are not overriding |
| Wrong region | Order region is correct; SOCKS is not resolving DNS locally |
| Exit changed mid-flow | A plain Session is not sticky or static |
If it still fails, keep the non-secret console fields (protocol/host/port) before opening a ticket. Programmatic ordering: API integration.
Limits
Use the samples only against targets you may access. This is not a guide to bypassing logins, CAPTCHAs, or platform rules. Prices and inventory follow the console (about $0.40/GB rotating, about $0.20/GB for the 100 TB bundle; shared static about $1.50 and dedicated about $5 per IP·month). USDT/USDC available; Visa/Mastercard applying. Not for mainland China.
FAQ
Can I use the sample hostname as-is?
No. proxy.example.invalid is a fake placeholder. Use the host and port the console returns.
Why set both the http and https keys?
If you omit one, that class of requests may skip the proxy. Pointing both keys at the same proxy URL is the usual requests pattern.
Do I need SOCKS5?
Only if the console returns SOCKS and your library requires it. Many HTTPS clients work with an HTTP proxy. See HTTP / SOCKS5 setup.
What if the password has special characters?
URL-encode the username and password separately, then build the proxy URL. See Proxy format.
Does a Session keep the same IP?
Not necessarily. Connection reuse is not a static IP and not automatically a sticky session. Use static or console session parameters when you need a held exit.
May I use this to access other people’s accounts or bypass limits?
No. Lawful, authorized targets only.
What changes in code between rotating and static?
The client fields look similar. The difference is the product you bought. Choose the product first, then paste that order’s credentials.
Where are prices confirmed?
In the console. Published list: Pricing.