Como configurar proxies LatamProxies (2026)

Como o nome de usuário do proxy é construído?

Toda a segmentação vai para o nome de usuário, assim você nunca precisa de um host ou porta diferente por país. O formato completo é USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}. Toda parte após USERNAME é opcional.

• USERNAME sozinho: um IP rotativo de qualquer país suportado.
• USERNAME-country-mx: um IP rotativo no México.
• USERNAME-country-ar-city-buenos_aires: um IP rotativo em Buenos Aires.
• USERNAME-country-br-session-abc123-ttl-30: o mesmo IP brasileiro por até 30 minutos.

Códigos de país são códigos ISO de duas letras em minúsculas. Nomes de cidades são em minúsculas com _ no lugar dos espaços e sem acentos: sao_paulo, não São Paulo. Não adicione outros parâmetros: o gateway não lê parâmetros ASN, CEP ou operadora no nome de usuário.

Como testar o proxy com cURL?

cURL é a forma mais rápida de verificar se suas credenciais e segmentação funcionam. A requisição abaixo passa pelo gateway HTTP e imprime o IP de saída. Substitua USERNAME e PASSWORD pelos valores do seu painel.

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

Como usar o proxy com Python requests?

Com requests, defina a mesma URL do proxy para http e https. Alvos HTTPS são tunelados pelo gateway HTTP com CONNECT, então o esquema da URL do proxy permanece http://. Para SOCKS5, instale requests[socks] e use socks5h:// para que o DNS seja resolvido pelo proxy, no país alvo.

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

Como uso o proxy com Node.js?

No Node.js 18 ou superior, o fetch embutido não lê as configurações de proxy, então use o ProxyAgent do undici e passe como dispatcher. Com axios, use https-proxy-agent e configure proxy: false para que o axios não aplique sua própria lógica de 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);

Como uso o proxy com Playwright?

Playwright aceita o servidor proxy, nome de usuário e senha no lançamento. Use uma sessão fixa para trabalho no navegador: uma página carrega muitos recursos, e um IP por página mantém a sessão consistente. Mude o id da sessão para obter um novo IP para o próximo contexto do navegador.

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

Como uso o proxy com Puppeteer?

O Chrome não aceita credenciais dentro do --proxy-server, então o Puppeteer passa o servidor como argumento de lançamento e o nome de usuário e senha com 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 usar sessões rotativas ou fixas?

Use IPs rotativos para requisições independentes e sessões fixas para fluxos com múltiplas etapas. IP novo a cada solicitação, ou sessões fixas de até 30 minutos.

• Rotativas (sem session): melhor para rastrear muitas páginas de produtos, como monitoramento de preços no Mercado Libre, ou para checar resultados de busca de vários locais.
• Fixas (-session-ID-ttl-30): melhor para automação de navegador, paginação que depende de cookies, testes de fluxo de checkout na sua própria loja e jornadas de verificação de anúncios.

Para portas dedicadas 4G/5G, a rotação funciona diferente: você troca o IP via link da API. Veja o guia de rotação de proxies móveis 4G.

O que significam os erros comuns?

A maioria dos problemas vem da string do nome de usuário ou do site alvo:

• 407 Proxy Authentication Required: nome de usuário ou senha errados. Verifique espaços e codifique caracteres especiais na senha.
• Conexão recusada ou timeout na conexão: verifique host e porta. HTTP usa 7777, SOCKS5 usa 7778.
• País errado: confira o código do país (br, não bra) e a grafia da cidade (sao_paulo).
• 403 ou CAPTCHA do alvo: desacelere, rode com mais frequência ou use sessão fixa com navegador real.
• Alvo recusado pelo gateway: bancos, portais governamentais, portais de pagamento e SMTP são bloqueados pela nossa Política de Uso Aceitável.

Se o problema continuar, envie um email para [email protected] com sua string de usuário (sem a senha), o alvo e o erro.