Come configurare proxy residenziali LatamProxies (2026)

Come si costruisce lo username del proxy?

Tutto il targeting va nello username, così non serve un host o porta diversi per ogni paese. Il formato completo è USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}. Ogni parte dopo USERNAME è opzionale.

• USERNAME da solo: un IP rotante da qualsiasi paese supportato.
• USERNAME-country-mx: un IP rotante in Messico.
• USERNAME-country-ar-city-buenos_aires: un IP rotante a Buenos Aires.
• USERNAME-country-br-session-abc123-ttl-30: lo stesso IP brasiliano per fino a 30 minuti.

I codici paese sono codici ISO a due lettere in minuscolo. I nomi delle città sono minuscoli con _ al posto degli spazi e senza accenti: sao_paulo, non São Paulo. Non aggiungere altri parametri: il gateway non legge ASN, CAP o parametri carrier nello username.

Come posso testare il proxy con cURL?

cURL è il modo più veloce per verificare che le tue credenziali e il targeting funzionino. La richiesta qui sotto passa attraverso il gateway HTTP e stampa l'IP di uscita. Sostituisci USERNAME e PASSWORD con i valori dal tuo cruscotto.

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

Come uso il proxy con Python requests?

Con requests, imposta la stessa URL del proxy sia per http che per https. Gli obiettivi HTTPS sono tunnelati tramite il gateway HTTP con CONNECT, quindi lo schema URL del proxy rimane http://. Per SOCKS5, installa requests[socks] e usa socks5h:// così il DNS viene risolto tramite il proxy, nel paese target.

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

Come uso il proxy con Node.js?

In Node.js 18 o versioni successive, il fetch integrato non legge le impostazioni del proxy, quindi usa il ProxyAgent di undici e passalo come dispatcher. Con axios, usa https-proxy-agent e imposta proxy: false così axios non applica la sua logica 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);

Come uso il proxy con Playwright?

Playwright accetta il server proxy, nome utente e password al lancio. Usa una sessione sticky per il lavoro con il browser: una pagina carica molte risorse, e un IP per pagina mantiene la sessione coerente. Cambia l'id della sessione per ottenere un nuovo IP per il prossimo contesto del browser.

// 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()

Come uso il proxy con Puppeteer?

Chrome non accetta le credenziali all'interno di --proxy-server, quindi Puppeteer passa il server come argomento di avvio e il nome utente e la password con 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();

Devo usare sessioni rotanti o sticky?

Usa proxy residenziali con IP rotanti per richieste indipendenti e sessioni sticky per flussi multi-step. Nuovo IP a ogni richiesta, oppure sessioni sticky fino a 30 minuti.

• Rotanti (senza session): ideali per scansionare molte pagine prodotto, come il monitoraggio prezzi di Mercado Libre, o per controllare risultati di ricerca da molte località.
• Sticky (-session-ID-ttl-30): perfetti per automazione browser, paginazione che dipende dai cookie, test di checkout sul tuo store e percorsi di verifica annunci.

Per le porte dedicate 4G/5G, la rotazione funziona diversamente: cambi l'IP tramite un link API. Vedi la guida alla rotazione dei proxy mobili.

Cosa significano gli errori comuni?

La maggior parte dei problemi deriva dalla stringa del nome utente o dal sito target:

• 407 Proxy Authentication Required: nome utente o password errati. Controlla spazi e codifica URL i caratteri speciali nella password.
• Connessione rifiutata o timeout alla connessione: verifica host e porta. HTTP usa 7777, SOCKS5 usa 7778.
• Paese sbagliato: controlla il codice paese (br, non bra) e l'ortografia della città (sao_paulo).
• 403 o CAPTCHA dal target: rallenta, ruota più spesso o usa una sessione sticky con un browser reale.
• Target rifiutato dal gateway: banche, portali governativi, portali di pagamento e SMTP sono bloccati dalla nostra Politica di Uso Accettabile.

Se il problema persiste, scrivi a [email protected] con la tua stringa nome utente (senza password), il target e l'errore.