Comment configurer des proxies LatamProxies (2026)

Comment est construit le nom d'utilisateur du proxy ?

Tous les ciblages sont intégrés dans le nom d'utilisateur, vous n'avez donc jamais besoin d'un hôte ou d'un port différent par pays. Le format complet est USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}. Chaque partie après USERNAME est optionnelle.

• USERNAME seul : une IP rotative depuis n'importe quel pays supporté.
• USERNAME-country-mx : une IP rotative au Mexique.
• USERNAME-country-ar-city-buenos_aires : une IP rotative à Buenos Aires.
• USERNAME-country-br-session-abc123-ttl-30 : la même IP brésilienne pendant jusqu'à 30 minutes.

Les codes pays sont des codes ISO à deux lettres en minuscules. Les noms de villes sont en minuscules avec _ à la place des espaces et sans accents : sao_paulo, pas São Paulo. N'ajoutez pas d'autres paramètres : la passerelle ne lit pas les paramètres ASN, ZIP ou opérateur dans le nom d'utilisateur.

Comment tester le proxy avec cURL ?

cURL est le moyen le plus rapide pour vérifier que vos identifiants et ciblages fonctionnent. La requête ci-dessous passe par la passerelle HTTP et affiche l'IP de sortie. Remplacez USERNAME et PASSWORD par les valeurs de votre tableau de bord.

curl -x http://gw.latamproxies.com:7777 \
  -U "USERNAME-country-br:PASSWORD" \
  https://api.ipify.org?format=json

curl --socks5-hostname gw.latamproxies.com:7778 \
  -U "USERNAME-country-mx-city-mexico_city-session-abc123-ttl-30:PASSWORD" \
  https://api.ipify.org?format=json

Comment utiliser le proxy avec Python requests ?

Avec requests, définissez la même URL de proxy pour http et https. Les cibles HTTPS sont tunnelisées via la passerelle HTTP avec CONNECT, donc le schéma URL du proxy reste http://. Pour SOCKS5, installez requests[socks] et utilisez socks5h:// pour que le DNS soit résolu via le proxy, dans le pays cible.

import requests

USER = "USERNAME-country-co"
PASS = "PASSWORD"
proxy = f"http://{USER}:{PASS}@gw.latamproxies.com:7777"

proxies = {"http": proxy, "https": proxy}
r = requests.get("https://api.ipify.org?format=json", proxies=proxies, timeout=30)
print(r.json())

# pip install "requests[socks]"
import requests

USER = "USERNAME-country-br-city-sao_paulo-session-job42-ttl-30"
PASS = "PASSWORD"
proxy = f"socks5h://{USER}:{PASS}@gw.latamproxies.com:7778"

with requests.Session() as s:
    s.proxies = {"http": proxy, "https": proxy}
    for _ in range(3):
        print(s.get("https://api.ipify.org?format=json", timeout=30).json())  # same IP 3 times

Comment utiliser le proxy avec Node.js ?

Dans Node.js 18 ou plus récent, le module intégré fetch ne lit pas les paramètres proxy, utilisez donc undici avec ProxyAgent et passez-le en tant que dispatcher. Avec axios, utilisez https-proxy-agent et définissez proxy: false pour qu'axios n'applique pas sa propre logique proxy.

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

const user = 'USERNAME-country-ar';
const pass = 'PASSWORD';
const dispatcher = new ProxyAgent({
  uri: 'http://gw.latamproxies.com:7777',
  token: 'Basic ' + Buffer.from(`${user}:${pass}`).toString('base64'),
});

const res = await fetch('https://api.ipify.org?format=json', { dispatcher });
console.log(await res.json());

// npm install axios https-proxy-agent
import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const user = encodeURIComponent('USERNAME-country-cl');
const pass = encodeURIComponent('PASSWORD');
const agent = new HttpsProxyAgent(`http://${user}:${pass}@gw.latamproxies.com:7777`);

const { data } = await axios.get('https://api.ipify.org?format=json', {
  httpsAgent: agent,
  proxy: false,
  timeout: 30000,
});
console.log(data);

Comment utiliser le proxy avec Playwright ?

Playwright accepte le serveur proxy, le nom d'utilisateur et le mot de passe au lancement. Utilisez une session sticky pour le travail navigateur : une page charge de nombreuses ressources, et une IP par page maintient la session cohérente. Changez l'id de session pour obtenir une nouvelle IP pour le contexte navigateur suivant.

// npm install playwright
import { chromium } from 'playwright';

const browser = await chromium.launch({
  proxy: {
    server: 'http://gw.latamproxies.com:7777',
    username: 'USERNAME-country-pe-city-lima-session-pw1-ttl-30',
    password: 'PASSWORD',
  },
});
const page = await browser.newPage();
await page.goto('https://api.ipify.org?format=json');
console.log(await page.textContent('body'));
await browser.close();

# pip install playwright && playwright install chromium
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.latamproxies.com:7777",
        "username": "USERNAME-country-br-session-pw2-ttl-30",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org?format=json")
    print(page.text_content("body"))
    browser.close()

Comment utiliser le proxy avec Puppeteer ?

Chrome n'accepte pas les identifiants dans --proxy-server, donc Puppeteer passe le serveur comme argument de lancement et le nom d'utilisateur et mot de passe avec page.authenticate().

// npm install puppeteer
import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://gw.latamproxies.com:7777'],
});
const page = await browser.newPage();
await page.authenticate({
  username: 'USERNAME-country-mx-city-mexico_city-session-pp1-ttl-30',
  password: 'PASSWORD',
});
await page.goto('https://api.ipify.org?format=json');
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();

Dois-je utiliser des sessions rotatives ou sticky ?

Utilisez des IPs rotatives pour des requêtes indépendantes et des sessions sticky pour des flux multi-étapes. Nouvelle IP à chaque requête, ou sessions persistantes jusqu'à 30 minutes.

• Rotatives (sans session) : idéales pour crawler de nombreuses pages produits, comme la surveillance des prix sur Mercado Libre, ou pour vérifier les résultats de recherche depuis plusieurs endroits.
• Sticky (-session-ID-ttl-30) : parfait pour l'automatisation navigateur, la pagination dépendant des cookies, les tests de parcours d'achat sur votre propre boutique et les parcours de vérification publicitaire.

Pour les ports dédiés 4G/5G, la rotation fonctionne différemment : vous changez l'IP via un lien API. Consultez le guide de rotation proxy mobile.

Que signifient les erreurs courantes ?

La plupart des problèmes viennent de la chaîne de nom d'utilisateur ou du site cible :

• 407 Proxy Authentication Required : nom d'utilisateur ou mot de passe incorrect. Vérifiez les espaces et encodez les caractères spéciaux dans le mot de passe.
• Connexion refusée ou timeout à la connexion : vérifiez l'hôte et le port. HTTP utilise 7777, SOCKS5 utilise 7778.
• Mauvais pays : vérifiez le code pays (br, pas bra) et l'orthographe de la ville (sao_paulo).
• 403 ou CAPTCHA du site cible : ralentissez, faites tourner plus souvent, ou utilisez une session sticky avec un vrai navigateur.
• Cible refusée par la passerelle : banques, portails gouvernementaux, portails de paiement et SMTP sont bloqués par notre Politique d'Utilisation Acceptable.

Si le problème persiste, envoyez un email à [email protected] avec votre chaîne nom d'utilisateur (sans le mot de passe), la cible et l'erreur.