# Cómo configurar proxies LatamProxies (2026)

> Configura proxies latinoamericanos LatamProxies en cURL, Python, Node.js, Playwright y Puppeteer: puerto 7777, SOCKS5, segmentación por país. Sin KYC, paga con criptomonedas.

- URL: https://latamproxies.com/es/guides/proxy-setup/
- Última actualización: 2026-10-05
- Publisher: LatamProxies (https://latamproxies.com)

Ejemplos para copiar y pegar en cURL, Python, Node.js, Playwright y Puppeteer, con segmentación por país, ciudad y sesión persistente para América Latina.

**Respuesta rápida — ¿Cómo configuro proxies LatamProxies?**

Para configurar proxies **LatamProxies**, apunta tu herramienta a `gw.latamproxies.com` en el puerto `7777` (HTTP/HTTPS) o `7778` (SOCKS5). Pon tu segmentación en el nombre de usuario, por ejemplo `USERNAME-country-br-city-sao_paulo`, y usa tu contraseña de proxy. El tráfico residencial comienza en 0,50 US$/GB. Sin KYC — sin identificación, sin selfie, sin documentos. Paga con criptomonedas.

## Detalles de conexión

| Atributo | Valor |
| --- | --- |
| Host de la puerta de enlace | `gw.latamproxies.com` |
| Puerto HTTP / HTTPS | `7777` |
| Puerto SOCKS5 | `7778` |
| Formato de nombre de usuario | `USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}` |
| Código de país | ISO 3166-1, minúsculas: `br`, `mx`, `ar`, `co`, `cl`, `pe` |
| Ciudad | Minúsculas, espacios como `_`: `sao_paulo`, `mexico_city`, `buenos_aires` |
| Rotación | IP nueva en cada solicitud, o sesiones persistentes de hasta 30 minutos |
| Precio | Proxy residencial desde 0,50 US$/GB · sin KYC · pagar con criptomonedas |
| Recargar | Mínimo 25 US$ en criptomonedas; el saldo no utilizado permanece en tu cuenta |

## ¿Cómo paso del pago a la primera solicitud?

Cinco pasos, unos minutos en total una vez que se confirme tu pago.

1. **Comprar un plan** — Elige un plan en la página de precios y paga en USDT, BTC, USDC, ETH, LTC o SOL. El plan 1 GB a 2,63 US$ es suficiente para probar. El plan pequeño se paga con una recarga mínima de 25 US$; el resto queda en tu saldo (nunca expira, no reembolsable).
2. **Copia tus credenciales** — Abre el panel y copia tu nombre de usuario y contraseña del proxy. No son tu número de cuenta.
3. **Construye el nombre de usuario** — Agrega segmentación al nombre de usuario: -country-br para Brasil, -city-sao_paulo para una ciudad, -session-abc123-ttl-30 para una IP fija.
4. **Prueba con cURL** — Ejecuta una solicitud cURL a través de la puerta de enlace y verifica que la IP y el país sean los que solicitaste.
5. **Conéctalo a tu herramienta** — Usa los ejemplos abajo para Python, Node.js, Playwright o Puppeteer.

## ¿Cómo se construye el nombre de usuario del proxy?

Toda la segmentación va en el nombre de usuario, así nunca necesitas un host o puerto diferente por país. El formato completo es `USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}`. Cada parte después de `USERNAME` es opcional.

- `USERNAME` solo: una IP rotativa de cualquier país soportado.
- `USERNAME-country-mx`: una IP rotativa en [México](https://latamproxies.com/es/residential-proxies/mexico/).
- `USERNAME-country-ar-city-buenos_aires`: una IP rotativa en [Buenos Aires](https://latamproxies.com/es/residential-proxies/argentina/buenos-aires/).
- `USERNAME-country-br-session-abc123-ttl-30`: la misma IP brasileña hasta por 30 minutos.

Los códigos de país son códigos ISO de dos letras en minúsculas. Los nombres de ciudad en minúsculas con `_` en lugar de espacios y sin acentos: `sao_paulo`, no `São Paulo`. No agregues otros parámetros: la puerta de enlace no lee parámetros ASN, ZIP o carrier en el nombre de usuario.

### Parámetros del nombre de usuario

| Parámetro | Ejemplo | Qué hace |
| --- | --- | --- |
| `country` | `-country-co` | IP de salida en ese país (Colombia aquí) |
| `city` | `-city-mexico_city` | IP de salida en esa ciudad; úsalo junto con `country` |
| `session` | `-session-job42` | Mantiene la misma IP mientras el id sea el mismo |
| `ttl` | `-ttl-30` | Duración de la sesión en minutos, hasta 30 minutos |

## ¿Cómo pruebo el proxy con cURL?

cURL es la forma más rápida de verificar que tus credenciales y el objetivo funcionen. La solicitud a continuación pasa por la puerta de enlace HTTP y muestra la IP de salida. Reemplaza `USERNAME` y `PASSWORD` con los valores de tu panel.

*cURL — puerta de enlace HTTP, Brasil*

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

*cURL — SOCKS5, Ciudad de México, sesión sticky de 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
```

## ¿Cómo uso el proxy con Python requests?

Con `requests`, configura la misma URL del proxy para `http` y `https`. Los objetivos HTTPS se tunelizan a través de la puerta de enlace HTTP con CONNECT, así que el esquema de URL del proxy permanece `http://`. Para SOCKS5, instala `requests[socks]` y usa `socks5h://` para que el DNS se resuelva a través del proxy, en el país objetivo.

*Python requests — IP rotativa en Colombia*

```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, sesión sticky en 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
```

## ¿Cómo uso el proxy con Node.js?

En Node.js 18 o superior, el `fetch` incorporado no lee la configuración del proxy, así que usa `undici`'s `ProxyAgent` y pásalo como `dispatcher`. Con `axios`, usa `https-proxy-agent` y configura `proxy: false` para que axios no aplique su propia 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 con 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);
```

## ¿Cómo uso el proxy con Playwright?

Playwright acepta el servidor proxy, nombre de usuario y contraseña al iniciar. Usa una sesión sticky para el trabajo con el navegador: una página carga muchos recursos, y una IP por página mantiene la sesión consistente. Cambia el id de sesión para obtener una IP nueva para el siguiente contexto del navegador.

*Playwright (Node.js) — IP sticky en 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()
```

## ¿Cómo uso el proxy con Puppeteer?

Chrome no acepta credenciales dentro de `--proxy-server`, así que Puppeteer pasa el servidor como argumento de lanzamiento y el nombre de usuario y contraseña con `page.authenticate()`.

*Puppeteer — IP sticky en Ciudad de 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();
```

## ¿Debo usar sesiones rotativas o sticky?

Usa IPs rotativas para solicitudes independientes y sesiones sticky para flujos de varios pasos. IP nueva en cada solicitud, o sesiones persistentes de hasta 30 minutos.

- **Rotativas** (sin `session`): ideales para rastrear muchas páginas de productos, como [monitoreo de precios en Mercado Libre](https://latamproxies.com/es/use-cases/mercado-libre-price-monitoring/), o para revisar resultados de búsqueda desde muchos lugares.
- **Sticky** (`-session-ID-ttl-30`): ideales para automatización de navegador, paginación que depende de cookies, pruebas de flujo de compra en tu propia tienda y recorridos de [verificación de anuncios](https://latamproxies.com/es/use-cases/ad-verification/).

Para puertos dedicados 4G/5G, la rotación funciona diferente: cambias la IP mediante un enlace API. Consulta la [guía de rotación de proxies móviles](https://latamproxies.com/es/guides/mobile-proxy-rotation/).

## ¿Qué significan los errores comunes?

La mayoría de los problemas vienen de la cadena del nombre de usuario o del sitio objetivo:

- **407 Proxy Authentication Required**: el nombre de usuario o la contraseña son incorrectos. Revisa espacios y codifica caracteres especiales en la contraseña.
- **Conexión rechazada o tiempo agotado al conectar**: verifica el host y puerto. HTTP usa `7777`, SOCKS5 usa `7778`.
- **País incorrecto**: verifica el código de país (`br`, no `bra`) y la ortografía de la ciudad (`sao_paulo`).
- **403 o CAPTCHA del objetivo**: reduce la velocidad, rota más seguido o usa una sesión sticky con un navegador real.
- **Objetivo rechazado por la puerta de enlace**: bancos, portales gubernamentales, portales de pago y SMTP están bloqueados por nuestra [Política de Uso Aceptable](https://latamproxies.com/es/acceptable-use-policy/).

Si el problema continúa, envía un correo a support@latamproxies.com con tu cadena de nombre de usuario (sin la contraseña), el objetivo y el error.

## Preguntas de configuración

### ¿Qué host y puerto usan los proxies LatamProxies?

Todo el tráfico residencial pasa por `gw.latamproxies.com`. Usa el puerto `7777` para objetivos HTTP y HTTPS, y el puerto `7778` para SOCKS5. El mismo host y puertos funcionan para todos los países; la selección se hace en el nombre de usuario, por ejemplo `USERNAME-country-cl`.

### ¿Cómo apunto a un país específico de Latinoamérica?

Agrega `-country-` y el código ISO de dos letras en minúscula a tu nombre de usuario: `br` para Brasil, `mx` para México, `ar` para Argentina, `co` para Colombia, `cl` para Chile, `pe` para Perú. La lista completa de países 38 está en la [página de países](https://latamproxies.com/es/residential-proxies/countries/).

### ¿Cómo mantengo la misma IP?

Agrega `-session-` con cualquier id y `-ttl-` con un número de minutos, por ejemplo `USERNAME-country-br-session-abc123-ttl-30`. La IP se mantiene igual mientras reutilices ese id, hasta 30 minutos. Usa un id nuevo para obtener una IP nueva.

### ¿Debo usar HTTP o SOCKS5?

Usa HTTP en el puerto `7777` para la mayoría de las herramientas: navegadores, scrapers y librerías HTTP lo manejan nativamente, y los objetivos HTTPS se tunelizan de forma segura. Usa SOCKS5 en el puerto `7778` cuando una herramienta solo soporte SOCKS, o cuando quieras resolver DNS del lado del proxy con `socks5h://`.

### ¿Mi nombre de usuario del proxy es igual que mi número de cuenta?

No. Tu número de cuenta te permite ingresar al panel. Tu nombre de usuario y contraseña del proxy aparecen en el panel y solo se usan para la puerta de enlace. Nunca compartas tu número de cuenta ni lo pongas en scripts.

### ¿Puedo usar los proxies con Scrapy, Selenium u otras herramientas?

Sí. Cualquier herramienta que soporte proxies HTTP o SOCKS5 con autenticación por usuario y contraseña funciona con LatamProxies. Usa el mismo host, puerto y formato de nombre de usuario que muestra esta guía. Si una herramienta no puede enviar credenciales de proxy, contacta a support@latamproxies.com.

### ¿Cuánto cuesta probar la configuración?

El plan residencial más pequeño es 1 GB por 2,63 US$, suficiente para miles de solicitudes de prueba a una página ligera. Los planes más grandes cuestan menos por GB, hasta 0,50 US$/GB. Sin KYC — no se requiere ID, selfie ni documentos. Paga con criptomonedas. Consulta la [página de precios](https://latamproxies.com/es/pricing/). El plan pequeño se paga con una recarga mínima de 25 US$; el resto queda en tu saldo (nunca expira, no reembolsable).

**Obtén tus credenciales** Compra un plan con USDT, BTC u otra moneda y comienza a enviar solicitudes tan pronto como se acredite tu recarga. [Obtenga proxies residenciales — desde 0,50 US$/GB](https://latamproxies.com/es/pricing/) · [Proxies residenciales](https://latamproxies.com/es/residential-proxies/)

---

LatamProxies: LatamProxies es un proveedor sin KYC de proxies residenciales y móviles 4G/5G para América Latina y el Caribe — Brasil, México, Argentina, Colombia, Chile, Perú y más — que se paga solo con criptomonedas (USDT, BTC, USDC, ETH, LTC, SOL). El tráfico residencial comienza desde 0,50 US$/GB.