Getting Started with StatesideIP US Proxies (2026)

Which username segments can I use?

Each segment in a StatesideIP username sets one option. Add only the ones you need, in the order of the format: USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}.

How do I test the proxy with curl?

Run the HTTP test first, then the SOCKS5 test; both print the IP your request leaves from. Run each one twice: without a session segment, the IP should change. Use --socks5-hostname so DNS lookups also go through the proxy.

# HTTP/HTTPS gateway: rotating US IP
curl -x http://gw.statesideip.com:7777 \
  -U "USERNAME-country-us:PASSWORD" \
  "https://api.ipify.org?format=json"

# SOCKS5 gateway: rotating IP in Florida
curl --socks5-hostname gw.statesideip.com:7778 \
  -U "USERNAME-country-us-state-fl:PASSWORD" \
  "https://api.ipify.org?format=json"

# pip install requests
import requests

proxy = "http://USERNAME-country-us-state-ca:[email protected]:7777"
r = requests.get("https://api.ipify.org?format=json",
                 proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.json())

// npm install undici
import { fetch, ProxyAgent } from "undici";

const agent = new ProxyAgent({
  uri: "http://gw.statesideip.com:7777",
  token: "Basic " + Buffer.from("USERNAME-country-us-state-ny:PASSWORD").toString("base64"),
});
const res = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await res.json());

Rotating or sticky: which session type should I use?

Use rotating sessions for many independent requests, and sticky sessions for a flow that must keep one IP. Without a session segment, each request gets a new IP. With session-{id} and ttl-{minutes}, the IP stays for the time you set: 1 to 120 minutes, set per session with the ttl parameter.

• USERNAME-country-us-state-ga-city-atlanta-session-cart01-ttl-20 keeps one Atlanta IP for 20 minutes.
• Change the session ID to get a different sticky IP.
• A home IP can go offline before the session ends, so add retries.

How do I target a state, city, ZIP, ASN or Canadian province?

Change the segments after country-; the gateway, port and password stay the same.

• State: USERNAME-country-us-state-oh — Ohio.
• City: USERNAME-country-us-state-co-city-denver — Denver.
• ZIP code: USERNAME-country-us-zip-98101 — downtown Seattle.
• ASN: USERNAME-country-us-asn-5650 — Frontier's network.
• Canadian province: USERNAME-country-ca-state-on — Ontario. Canada uses the state segment for provinces.
• Canadian city: USERNAME-country-ca-state-bc-city-vancouver — Vancouver.

More examples: ZIP code targeting, ASN targeting and the US cities hub.

What does a 407 Proxy Authentication Required error mean?

A 407 error means the gateway did not accept your username or password. Check for a typo in a segment, or a missing colon between username and password. In a proxy URL, special characters in the password may need URL-encoding. Copy the password again from the dashboard. If the credentials are right, check your balance and contact support.

Why do requests time out?

Timeouts usually come from a filter that is too narrow, a slow home connection behind the IP, or a slow target. Widen a ZIP or ASN filter to the city or state. Set a client timeout of 30 seconds or more, and retry with a new IP. Sticky IPs can also drop when the home device goes offline.

Why does the IP show the wrong location?

Geolocation databases disagree, so a correct IP can look wrong in one lookup tool. First check that the country, state and city segments match each other. City names need underscores, as in city-san_antonio. Then compare two or three lookup services, and test the target site itself.