Premiers pas avec les proxies US StatesideIP (2026)

Quels segments de nom d'utilisateur puis-je utiliser ?

Chaque segment dans un nom d'utilisateur StatesideIP définit une option. Ajoutez uniquement ceux dont vous avez besoin, dans l’ordre du format : USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}.

Comment tester le proxy avec curl ?

Lancez d'abord le test HTTP, puis le test SOCKS5 ; les deux affichent l'IP depuis laquelle votre requête part. Lancez chaque test deux fois : sans segment session, l'IP doit changer. Utilisez --socks5-hostname pour que les requêtes DNS passent aussi par le 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());

Sessions rotatives ou persistantes : quel type de session dois-je utiliser ?

Utilisez des sessions rotatives pour de nombreuses requêtes indépendantes, et des sessions persistantes pour un flux qui doit conserver une IP unique. Sans segment session, chaque requête obtient une nouvelle IP. Avec session-{id} et ttl-{minutes}, l'IP reste pendant la durée que vous définissez : 1 à 120 minutes, défini par session avec le paramètre ttl.

• USERNAME-country-us-state-ga-city-atlanta-session-cart01-ttl-20 conserve une IP d'Atlanta pendant 20 minutes.
• Changez l'ID de session pour obtenir une IP persistante différente.
• Une IP résidentielle peut se déconnecter avant la fin de la session, donc ajoutez des tentatives de reconnexion.

Comment cibler un état, une ville, un code postal, un ASN ou une province canadienne ?

Modifiez les segments après country- ; la passerelle, le port et le mot de passe restent les mêmes.

• État : USERNAME-country-us-state-oh — Ohio.
• Ville : USERNAME-country-us-state-co-city-denver — Denver.
• Code postal : USERNAME-country-us-zip-98101 — centre-ville de Seattle.
• ASN : USERNAME-country-us-asn-5650 — réseau de Frontier.
• Province canadienne : USERNAME-country-ca-state-on — Ontario. Le Canada utilise le segment state pour les provinces.
• Ville canadienne : USERNAME-country-ca-state-bc-city-vancouver — Vancouver.

Plus d'exemples : ciblage par code postal, ciblage ASN et le hub des villes US.

Que signifie une erreur 407 Proxy Authentication Required ?

Une erreur 407 signifie que la passerelle n'a pas accepté votre nom d'utilisateur ou mot de passe. Vérifiez une faute de frappe dans un segment, ou un deux-points manquant entre le nom d'utilisateur et le mot de passe. Dans une URL proxy, les caractères spéciaux dans le mot de passe peuvent nécessiter un encodage URL. Copiez à nouveau le mot de passe depuis le tableau de bord. Si les identifiants sont corrects, vérifiez votre solde et contactez le support.

Pourquoi les requêtes expirent-elles ?

Les expirations viennent généralement d'un filtre trop restrictif, d'une connexion résidentielle lente derrière l'IP, ou d'une cible lente. Élargissez un filtre ZIP ou ASN à la ville ou à l'état. Réglez un délai d'attente client de 30 secondes ou plus, et réessayez avec une nouvelle IP. Les IP persistantes peuvent aussi être perdues si l'appareil résidentiel se déconnecte.

Pourquoi l'IP affiche-t-elle une mauvaise localisation ?

Les bases de données de géolocalisation divergent, donc une IP correcte peut sembler fausse dans un outil de recherche. Vérifiez d'abord que les segments pays, état et ville correspondent entre eux. Les noms de ville doivent contenir des underscores, comme dans city-san_antonio. Comparez ensuite deux ou trois services de recherche, et testez le site cible lui-même.