# Documentación de la API de proxies por ciudad y del gateway

> Documentación de Banyan Proxies: host y puertos del gateway, segmentos del nombre de usuario para país, ciudad, ASN y sesiones, códigos de error y ejemplos probados en curl, Python y Node.js.

- URL: https://banyanproxies.com/es/docs/
- Última actualización: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

Todo lo que necesitas para conectarte: un gateway, un formato de nombre de usuario y ejemplos probados que puedes pegar. La API de cuenta y pedidos está documentada en [documentación de la API](https://banyanproxies.com/docs/api/).

**Respuesta rápida — ¿Cómo me conecto a los proxies residenciales de Banyan Proxies?**

Conéctate a `gw.banyanproxies.com`, puerto 7777 para HTTP y HTTPS o 7778 para SOCKS5, con tu contraseña de proxy y un nombre de usuario formado por segmentos: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. Usa solo los segmentos que necesites. Todos los planes, desde 1,88 US$ por 1 GB, incluyen segmentación por ciudad y ASN.

## ¿Qué segmentos del nombre de usuario puedo usar?

Formato completo: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. Mantén el orden; omite lo que no necesites.

| Segmento | Ejemplo | Significado |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | Código de país ISO de dos letras, en minúsculas |
| `-city-<name>` | `-city-surabaya` | Nombre de la ciudad, en minúsculas, con guiones bajos en lugar de espacios |
| `-asn-<number>` | `-asn-7713` | Número de red del ISP, sin "AS" |
| `-session-<id>` | `-session-cart2` | Vincula las solicitudes a una IP fija |
| `-ttl-<minutes>` | `-ttl-20` | Duración fija (sticky), hasta 30 minutos |

## ¿Qué host, puertos y autenticación uso?

| Atributo | Valor |
| --- | --- |
| Host | `gw.banyanproxies.com` |
| Puerto HTTP / HTTPS | 7777 |
| Puerto SOCKS5 | 7778 |
| Autenticación | Usuario y contraseña en todos los planes, o una lista de IP permitidas (hasta 10 IP). Subusuarios con sus propias credenciales y límite de tráfico. Claves de API que puedes revocar en cualquier momento |
| Rotación | Cada nueva conexión recibe una IP del pool, normalmente distinta; para obtener una nueva IP en cada solicitud, envía una solicitud por conexión (desactiva keep-alive) |
| Sesiones fijas (sticky) | hasta 30 minutos (la IP puede cambiar antes) |
| Bloqueado | Sitios de banca, gobierno y portales de pago, además de los puertos SMTP (envío de correo) 25, 465 y 587 |

## ¿Qué ejemplos de código puedo copiar?

Cada ejemplo solicita una IP e imprime lo que ve un servicio de consulta. Reemplaza USERNAME y PASSWORD. La [página de segmentación por ciudad](https://banyanproxies.com/es/targeting/city/) y la [guía de sesiones fijas](https://banyanproxies.com/es/guides/sticky-sessions/) tienen más información.

*curl sobre SOCKS5: una IP de Wellington*

```bash
curl --socks5-hostname gw.banyanproxies.com:7778 \
  -U "USERNAME-country-nz-city-wellington:PASSWORD" \
  https://ipinfo.io/json
```

*Python (httpx): reintentar con una nueva sesión cuando falla una IP*

```python
import uuid

import httpx

HOST = "gw.banyanproxies.com"
PORT = 7777


def fetch(url, city="lahore", country="pk", tries=3):
    for _ in range(tries):
        sid = uuid.uuid4().hex[:8]
        user = f"USERNAME-country-{country}-city-{city}-session-{sid}-ttl-10"
        proxy = f"http://{user}:PASSWORD@{HOST}:{PORT}"
        try:
            with httpx.Client(proxy=proxy, timeout=30) as client:
                r = client.get(url)
                r.raise_for_status()
                return r.text
        except httpx.HTTPError as exc:
            print("retrying with a new IP:", exc)
    return None


print(fetch("https://ipinfo.io/json"))
```

*Node.js (undici): una IP de Ciudad Ho Chi Minh*

```javascript
// npm install undici
const { ProxyAgent, fetch } = require("undici");

const user = "USERNAME-country-vn-city-ho_chi_minh_city";
const token = "Basic " + Buffer.from(`${user}:PASSWORD`).toString("base64");
const dispatcher = new ProxyAgent({
  uri: "http://gw.banyanproxies.com:7777",
  token,
});

async function main() {
  const res = await fetch("https://ipinfo.io/json", { dispatcher });
  const info = await res.json();
  console.log(info.ip, info.city, info.region);
}

main().catch((err) => console.error(err.message));
```

*Playwright (Python): un navegador con una IP de Sídney y zona horaria coincidente*

```python
from playwright.sync_api import sync_playwright

PROXY = {
    "server": "http://gw.banyanproxies.com:7777",
    "username": "USERNAME-country-au-city-sydney-session-syd1-ttl-15",
    "password": "PASSWORD",
}

with sync_playwright() as p:
    browser = p.chromium.launch(proxy=PROXY)
    context = browser.new_context(
        timezone_id="Australia/Sydney",
        locale="en-AU",
    )
    page = context.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.inner_text("body"))
    browser.close()
```

## ¿Qué significan los códigos de error comunes?

| Código o síntoma | Causa probable | Qué hacer |
| --- | --- | --- |
| 407 Proxy Authentication Required | Usuario, contraseña o sintaxis de segmento incorrectos | Vuelve a copiar las credenciales; revisa guiones y guiones bajos |
| Tiempo de espera agotado al conectar | Puerto incorrecto o un firewall | Usa 7777 para HTTP, 7778 para SOCKS5 |
| Errores solo en una ciudad | Pocos dispositivos domésticos conectados allí ahora | Reintenta más tarde, usa una ciudad cercana o quita el segmento de ciudad |
| 403 o 429 del destino | El destino rechaza o limita la tasa de solicitudes | Baja el ritmo; respeta los términos del sitio y robots.txt |
| Conexión rechazada a un banco o puerto SMTP | Destino bloqueado | Estos destinos están bloqueados por política |

## ¿Dónde está el resto de la documentación?

- **[Documentación de la API](https://banyanproxies.com/docs/api/)** — Cuenta, recargas, pedidos, uso y claves API por HTTPS.
- **[Segmentación por ciudad](https://banyanproxies.com/es/targeting/city/)** — Reglas de escritura y ejemplos para cada ciudad.
- **[Segmentación por ASN](https://banyanproxies.com/es/targeting/asn/)** — Números de red de los principales ISP domésticos.
- **[Primeros pasos](https://banyanproxies.com/es/guides/getting-started/)** — Desde la recarga hasta la primera solicitud.

## ¿A dónde acudo cuando algo falla?

Revisa primero el [estado del servicio](https://banyanproxies.com/es/status/), luego el [verificador de ciudades de proxy](https://banyanproxies.com/es/guides/verify-proxy-city/) para dudas de ubicación y el [glosario](https://banyanproxies.com/es/glossary/) para los términos. Escribe a soporte desde la [página de contacto](https://banyanproxies.com/es/contact/).

## ¿Qué más preguntan los desarrolladores?

### ¿Necesito un endpoint especial por país o ciudad?

No. Una sola puerta de enlace da servicio a todas las ubicaciones; el nombre de usuario decide dónde está la IP.

### ¿Puedo usar una lista de IP permitidas en lugar de una contraseña?

Usuario y contraseña en todos los planes, o una lista de IP permitidas (hasta 10 IP). Subusuarios con sus propias credenciales y límite de tráfico. Claves de API que puedes revocar en cualquier momento.

### ¿Se prueban las muestras?

Cada muestra de Python se compila y cada muestra de JavaScript se verifica sintácticamente antes de publicarse. Instala primero las librerías que indican: httpx, undici o Playwright.

---

Banyan Proxies: Banyan Proxies es un proveedor de proxies residenciales para ciudades del sur y el sudeste de Asia y Oceanía, con pago en criptomonedas y sin subir identificación: IP domésticas segmentadas por ciudad en Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney y más, con facturación por GB.