CLI

cURL proxy setup

cURL is the fastest way to smoke-test a proxy. Point --proxy at your gateway and every request exits from a fresh residential IP — no config files, no SDK. Copy a line below, swap in your credentials, and you are through.

Start with 1 GB free View pricing
Get 1 GB of residential data — freeon your first $10+ top-upClaim it
Endpoint

Connection details

proxmint · gateway
Host : Port (HTTP)gw.proxmint.com:823
Host : Port (SOCKS5)gw.proxmint.com:824
UsernamePROXY_USER
PasswordPROXY_PASS

Swap PROXY_USER / PROXY_PASS for the credentials on your dashboard. New here? Create an account to generate a key.

Code

cURL proxy example

bash
# Rotating residential — a new IP on every request
curl --proxy "http://PROXY_USER:PROXY_PASS@gw.proxmint.com:823" https://api.ipify.org?format=json

# Target a country — append __cr.us to the username
curl --proxy "http://PROXY_USER__cr.us:PROXY_PASS@gw.proxmint.com:823" https://api.ipify.org

# SOCKS5 (port 824) — use socks5h so DNS resolves through the proxy
curl --proxy "socks5h://PROXY_USER:PROXY_PASS@gw.proxmint.com:824" https://api.ipify.org
Targeting

Steer the exit IP from the username

append to your username
CountryPROXY_USER__cr.us
Country + cityPROXY_USER__cr.us;city.newyork
Sticky IP (30 min)PROXY_USER__sessid.abc123;sessttl.30
Good to know

Tips & gotchas

  • socks5h (not socks5) resolves DNS on the exit side — use it to avoid DNS leaks.
  • Add ;city.newyork or ;sessid.abc123 to the username for city targeting or a sticky IP.
FAQ

cURL, answered

Why does my IP change on every cURL request?

The rotating gateway on port 823 hands you a fresh residential exit per request by design. To keep the same IP across calls, add a sticky session id to the username (__sessid.abc123) or use a sticky port.

How do I target a specific country in cURL?

Put the targeting in the username, not the URL: change PROXY_USER to PROXY_USER__cr.us for the US, or cr.gb for the UK. You can combine keys, e.g. __cr.us;city.newyork.

Ready to route cURL through residential IPs?

Create an account, paste the code above, and we'll add your first 1 GB of residential free on your first top-up. Pay by the GB after that — no subscription.

Claim your free 1 GB All integrations