Your first request in five minutes

This page has one goal: prove the credentials work and the exit IP really changed. How to compose options, pick regions, and debug errors each get their own page.

Get four values

Create a proxy account under Proxy generator in the console. You get a username and password; the gateway host and port are on the same page.

Send the shortest possible request

Start with no region options at all, to confirm the credentials themselves work. The IP that comes back is your exit for this request.

curl -x http://USERNAME:PASSWORD@GATEWAY_HOST:58971 \
  https://api.ipify.org?format=json

Getting an IP back means authentication, routing and metering all work end to end.

Now pick a country

Region options attach to the username, not a request header and not the password. This asks for a US exit that stays on the same IP for ten minutes.

curl -x 'http://USERNAME-country-US-session-demo1-time-10:PASSWORD@GATEWAY_HOST:58971' \
  https://api.ipify.org?format=json

Three things are worth memorising now, because they trip up almost everyone:

• country must be two uppercase letters. us is rejected, not silently uppercased.
• session and time must appear together. Supplying only one is rejected.
• Options must appear in a fixed order: country → state/region → city → asn → os → session → time. Out of order is a rejection, not a warning.

The complete option list and escaping rules are in Username option reference.

The same port speaks SOCKS5

No port change needed. The gateway looks at the first TCP byte: 0x05 means SOCKS5, anything else is parsed as HTTP.

curl -x 'socks5h://USERNAME-country-JP:PASSWORD@GATEWAY_HOST:58971' \
  https://api.ipify.org?format=json

Where to go next