Targeting a country, state or city

Add a two-letter country code to the password:

YOUR_KEY:standard_country-GB

That is all most people need. Use ISO codes: US, GB, DE, FR and so on.

Narrower than a country

State, city, ZIP code and network (ASN) are set with HTTP headers sent to the proxy, alongside a country in the password:

For HTTPS sites these go on the CONNECT request to the proxy, not to the website. They need HTTP on port 3128 — SOCKS5 has no way to carry them. The cleanproxy_geo tier is built for state and city work.

When nothing matches

If no IP is available for your exact targeting, the request fails with a message that says so. We do not quietly widen your targeting — you never get a Texas IP when you asked for Los Angeles. Retry, or broaden: drop the city and keep the state, or drop the state and keep the country.