# Como configurar proxies LatamProxies (2026)

> Configure proxies latamproxies LatamProxies na América Latina em cURL, Python, Node.js, Playwright e Puppeteer: porta 7777, SOCKS5, direcionamento por país. Sem KYC, pague com cripto.

- URL: https://latamproxies.com/pt/guides/proxy-setup/
- Última atualização: 2026-10-05
- Publisher: LatamProxies (https://latamproxies.com)

Exemplos prontos para cURL, Python, Node.js, Playwright e Puppeteer, com direcionamento por país, cidade e sessão persistente para América Latina.

**Resposta rápida — Como configurar proxies LatamProxies?**

Para configurar proxies **LatamProxies**, aponte sua ferramenta para `gw.latamproxies.com` na porta `7777` (HTTP/HTTPS) ou `7778` (SOCKS5). Coloque seu alvo no nome de usuário, por exemplo `USERNAME-country-br-city-sao_paulo`, e use sua senha do proxy. O tráfego residencial começa em US$ 0,50/GB. Sem KYC — sem ID, sem selfie, sem documentos. Pague com cripto.

## Detalhes da conexão

| Atributo | Valor |
| --- | --- |
| Host do gateway | `gw.latamproxies.com` |
| Porta HTTP / HTTPS | `7777` |
| Porta SOCKS5 | `7778` |
| Formato do nome de usuário | `USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}` |
| Código do país | ISO 3166-1, minúsculo: `br`, `mx`, `ar`, `co`, `cl`, `pe` |
| Cidade | Minúsculo, espaços como `_`: `sao_paulo`, `mexico_city`, `buenos_aires` |
| Rotação | IP novo a cada solicitação, ou sessões fixas de até 30 minutos |
| Preço | Proxy residencial a partir de US$ 0,50/GB · Sem KYC · pagar com cripto |
| Recarga | Mínimo de US$ 25 em cripto; saldo não utilizado permanece na sua conta |

## Como faço para ir do pagamento à primeira requisição?

Cinco passos, alguns minutos no total após a confirmação do pagamento.

1. **Comprar um plano** — Escolha um plano na página de preços e pague em USDT, BTC, USDC, ETH, LTC ou SOL. O plano 1 GB por US$ 2,63 é suficiente para testar. O plano pequeno é pago a partir de um recarregamento mínimo de US$ 25; o restante fica no seu saldo (nunca expira, não reembolsável).
2. **Copie suas credenciais** — Abra o painel e copie seu nome de usuário e senha do proxy. Eles não são seu número de conta.
3. **Monte o nome de usuário** — Adicione o alvo ao nome de usuário: -country-br para Brasil, -city-sao_paulo para uma cidade, -session-abc123-ttl-30 para um IP sticky.
4. **Teste com cURL** — Execute uma requisição cURL pelo gateway e verifique se o IP e o país são os que você pediu.
5. **Conecte na sua ferramenta** — Use os exemplos abaixo para Python, Node.js, Playwright ou Puppeteer.

## 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](https://latamproxies.com/pt/residential-proxies/mexico/).
- `USERNAME-country-ar-city-buenos_aires`: um IP rotativo em [Buenos Aires](https://latamproxies.com/pt/residential-proxies/argentina/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.

### Parâmetros do nome de usuário

| Parâmetro | Exemplo | O que faz |
| --- | --- | --- |
| `country` | `-country-co` | IP de saída naquele país (Colômbia aqui) |
| `city` | `-city-mexico_city` | IP de saída naquela cidade; use junto com `country` |
| `session` | `-session-job42` | Mantém o mesmo IP enquanto o id for o mesmo |
| `ttl` | `-ttl-30` | Duração da sessão em minutos, até 30 minutos |

## 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 — gateway HTTP, Brasil*

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

*cURL — SOCKS5, Cidade do México, proxy residencial 30 minutos*

```bash
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.

*Python requests — IP rotativo na Colômbia*

```python
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())
```

*Python requests — SOCKS5, sessão fixa em São Paulo*

```python
# 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.

*Node.js — undici ProxyAgent, Argentina*

```javascript
// 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());
```

*Node.js — axios com https-proxy-agent, Chile*

```javascript
// 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.

*Playwright (Node.js) — IP fixo em Lima*

```javascript
// 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();
```

*Playwright (Python) — Brasil*

```python
# 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()`.

*Puppeteer — IP fixo na Cidade do México*

```javascript
// 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](https://latamproxies.com/pt/use-cases/mercado-libre-price-monitoring/), 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](https://latamproxies.com/pt/use-cases/ad-verification/).

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](https://latamproxies.com/pt/guides/mobile-proxy-rotation/).

## 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](https://latamproxies.com/pt/acceptable-use-policy/).

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

## Perguntas sobre configuração

### Qual host e porta os proxies LatamProxies usam?

Todo o tráfego residencial passa por `gw.latamproxies.com`. Use a porta `7777` para alvos HTTP e HTTPS, e a porta `7778` para SOCKS5. O mesmo host e portas funcionam para todos os países; o direcionamento é definido no nome de usuário, por exemplo `USERNAME-country-cl`.

### Como direcionar para um país específico da América Latina?

Adicione `-country-` e o código ISO de duas letras em minúsculas no seu nome de usuário: `br` para Brasil, `mx` para México, `ar` para Argentina, `co` para Colômbia, `cl` para Chile, `pe` para Peru. A lista completa de países 38 está na [página de países](https://latamproxies.com/pt/residential-proxies/countries/).

### Como manter o mesmo IP?

Adicione `-session-` com qualquer id e `-ttl-` com um número de minutos, por exemplo `USERNAME-country-br-session-abc123-ttl-30`. O IP permanece o mesmo enquanto você reutiliza esse id, até 30 minutos. Use um id novo para obter um IP novo.

### Devo usar HTTP ou SOCKS5?

Use HTTP na porta `7777` para a maioria das ferramentas: navegadores, scrapers e bibliotecas HTTP lidam nativamente, e alvos HTTPS são tunelados com segurança. Use SOCKS5 na porta `7778` quando uma ferramenta suporta apenas SOCKS, ou quando quiser resolução DNS no lado do proxy com `socks5h://`.

### Meu nome de usuário do proxy é o mesmo que meu número de conta?

Não. Seu número de conta é usado para acessar o painel. Seu nome de usuário e senha do proxy são exibidos no painel e usados apenas para o gateway. Nunca compartilhe seu número de conta e nunca o coloque em scripts.

### Posso usar os proxies com Scrapy, Selenium ou outras ferramentas?

Sim. Qualquer ferramenta que suporte proxies HTTP ou SOCKS5 com autenticação por nome de usuário e senha funciona com LatamProxies. Use o mesmo host, porta e formato de nome de usuário mostrados neste guia. Se uma ferramenta não conseguir enviar as credenciais do proxy, entre em contato com support@latamproxies.com.

### Quanto custa testar a configuração?

O menor plano residencial custa 1 GB por US$ 2,63, suficiente para milhares de requisições de teste em uma página leve. Planos maiores custam menos por GB, chegando a US$ 0,50/GB. Sem KYC — sem ID, sem selfie, sem documentos. Pague com cripto. Veja a [página de preços](https://latamproxies.com/pt/pricing/). O plano pequeno é pago a partir de um recarregamento mínimo de US$ 25; o restante fica no seu saldo (nunca expira, não reembolsável).

**Obtenha suas credenciais** Compre um plano com USDT, BTC ou outra moeda e comece a enviar requisições assim que seu recarregamento for creditado. [Obtenha proxies residenciais — a partir de US$ 0,50/GB](https://latamproxies.com/pt/pricing/) · [Proxies residenciais](https://latamproxies.com/pt/residential-proxies/)

---

LatamProxies: LatamProxies é um provedor de proxies residenciais e móveis 4G/5G sem KYC para a América Latina e o Caribe — Brasil, México, Argentina, Colômbia, Chile, Peru e mais — pago somente em cripto (USDT, BTC, USDC, ETH, LTC, SOL). O tráfego residencial começa em US$ 0,50/GB.