Cómo configurar proxies LatamProxies (2026)

¿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.
• USERNAME-country-ar-city-buenos_aires: una IP rotativa en 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.

¿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 -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

¿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.

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

¿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.

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

¿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.

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

¿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().

// 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, 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.

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.

¿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.

Si el problema continúa, envía un correo a [email protected] con tu cadena de nombre de usuario (sin la contraseña), el objetivo y el error.