Sin KYC — sin documento de identidad, sin selfie, sin documentos · Segmentación por ciudad en todos los planes · Pago en criptomonedas
Idioma: Español
Empezar

Docs · HTTP, HTTPS, SOCKS5

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

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.

Última actualización: · 4 min de lectura

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.

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

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

Hostgw.banyanproxies.com
Puerto HTTP / HTTPS7777
Puerto SOCKS57778
AutenticaciónUsuario 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ónCada 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)
BloqueadoSitios 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 y la guía de sesiones fijas tienen más información.

curl sobre SOCKS5: una IP de Wellington
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
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
// 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
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íntomaCausa probableQué hacer
407 Proxy Authentication RequiredUsuario, contraseña o sintaxis de segmento incorrectosVuelve a copiar las credenciales; revisa guiones y guiones bajos
Tiempo de espera agotado al conectarPuerto incorrecto o un firewallUsa 7777 para HTTP, 7778 para SOCKS5
Errores solo en una ciudadPocos dispositivos domésticos conectados allí ahoraReintenta más tarde, usa una ciudad cercana o quita el segmento de ciudad
403 o 429 del destinoEl destino rechaza o limita la tasa de solicitudesBaja el ritmo; respeta los términos del sitio y robots.txt
Conexión rechazada a un banco o puerto SMTPDestino bloqueadoEstos destinos están bloqueados por política

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

¿A dónde acudo cuando algo falla?

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.

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

1 GB 1,88 US$ · segmentación por ciudad · sin KYC

Empezar