Proxy con IP de ciudad específica: el parámetro de ciudad

¿Cómo se construye el nombre de usuario de ciudad?

El nombre de usuario es una cadena de segmentos unidos por guiones. El formato completo es USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}; usa solo los segmentos que necesites, en ese orden.

• USERNAME-country-in-city-bengaluru: cualquier IP doméstica en Bengaluru, una nueva en cada conexión.
• USERNAME-country-id-city-surabaya: Surabaya, Java Oriental.
• USERNAME-country-vn-city-ho_chi_minh_city: Ciudad Ho Chi Minh; los espacios se convierten en guiones bajos.
• USERNAME-country-au-city-gold_coast-session-gc1-ttl-15: una IP de Gold Coast conservada durante 15 minutos.
• USERNAME-country-pk-city-lahore-asn-17557: Lahore en la red de PTCL (AS17557).

El código de país es el código ISO de dos letras en minúsculas. Envía siempre el país junto con la ciudad: Hyderabad existe en India y en Pakistán, y country-pk-city-hyderabad no es el mismo lugar que country-in-city-hyderabad.

¿Cómo escribo ciudades con dos nombres o con acentos?

Usa el nombre en inglés sin acentos, tal como aparece en la página de cada ciudad: bengaluru, chattogram, george_town. Algunas ciudades también tienen un nombre antiguo, como Bangalore o Chittagong. Si la grafía de la página no devuelve ninguna IP mientras el país sí funciona, prueba el nombre antiguo y avisa al soporte para que podamos corregir la página. El índice de ciudades recoge todas las grafías que publicamos.

¿Cómo pruebo una IP de ciudad con curl, Python y Node.js?

Envía una petición a través del gateway e imprime la IP de salida y el lugar que indica tu servicio de búsqueda. Usa un servicio de búsqueda al que tengas permiso para llamar; los ejemplos usan el endpoint público de ipinfo.io.

# Rotating Jakarta IP over HTTP
curl -x http://gw.banyanproxies.com:7777 \
  -U "USERNAME-country-id-city-jakarta:PASSWORD" \
  https://ipinfo.io/json

# One Jakarta IP kept for 10 minutes, over SOCKS5
curl --socks5-hostname gw.banyanproxies.com:7778 \
  -U "USERNAME-country-id-city-jakarta-session-jkt1-ttl-10:PASSWORD" \
  https://ipinfo.io/json

import requests

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

cities = {
    "in": "mumbai",
    "th": "chiang_mai",
    "au": "perth",
}

for country, city in cities.items():
    user = f"USERNAME-country-{country}-city-{city}"
    proxy = f"http://{user}:PASSWORD@{HOST}:{PORT}"
    try:
        r = requests.get(
            "https://ipinfo.io/json",
            proxies={"http": proxy, "https": proxy},
            timeout=30,
        )
        info = r.json()
        print(city, info.get("ip"), info.get("city"), info.get("region"))
    except requests.RequestException as exc:
        print(city, "failed:", exc)

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

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

fetch("https://ipinfo.io/json", { dispatcher: agent })
  .then((res) => res.json())
  .then((info) => console.log(info.ip, info.city, info.region))
  .catch((err) => console.error("failed:", err.message));

¿Qué pasa cuando no hay ninguna IP en línea en una ciudad?

Una ciudad pequeña puede tener pocos dispositivos domésticos en línea en un momento dado. Comprueba siempre la ciudad de salida de la IP que recibes y luego:

1. Reintenta pasados unos minutos: los dispositivos domésticos se conectan y se desconectan a lo largo del día.
2. Usa una ciudad cercana de la misma página, por ejemplo Rawalpindi para Islamabad.
3. Quita el segmento -city- y mantén el país, si la tarea lo permite.

La disponibilidad de ciudades varía; el checkout muestra qué hay online.

¿Todos los sitios web verán la ciudad que he pedido?

No siempre. Los sitios web ubican una IP con su propia base de datos de geolocalización, y las bases de datos no coinciden, sobre todo cerca de los límites de las ciudades: una IP doméstica de Gurugram puede aparecer como Delhi, y una de Petaling Jaya como Kuala Lumpur. La guía de comprobación de ciudades muestra cómo probar la base de datos que usa tu objetivo antes de un trabajo grande.

¿Qué debería leer a continuación?

Configura sesiones con la guía de proxies residenciales fijos, copia el código de cliente de la documentación y consulta términos como ASN o CGNAT en el glosario. Todas las demás guías están en la página de guías.