Documentación de la API
Cuenta, recargas, pedidos, uso y claves API por HTTPS.
Docs · HTTP, HTTPS, SOCKS5
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.
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.
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 |
| 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 |
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 y la guía de sesiones fijas tienen más información.
curl --socks5-hostname gw.banyanproxies.com:7778 \
-U "USERNAME-country-nz-city-wellington:PASSWORD" \
https://ipinfo.io/jsonimport 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"))// 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));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()| 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 |
Cuenta, recargas, pedidos, uso y claves API por HTTPS.
Reglas de escritura y ejemplos para cada ciudad.
Números de red de los principales ISP domésticos.
Desde la recarga hasta la primera solicitud.
Revisa primero el estado del servicio, luego el verificador de ciudades de proxy para dudas de ubicación y el glosario para los términos. Escribe a soporte desde la página de contacto.
No. Una sola puerta de enlace da servicio a todas las ubicaciones; el nombre de usuario decide dónde está la IP.
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.
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.
1 GB 1,88 US$ · segmentación por ciudad · sin KYC
Empezar