Proxy com IP de cidade específica: o parâmetro de cidade

Como o nome de usuário da cidade é montado?

O nome de usuário é uma sequência de segmentos unidos por hífens. O formato completo é USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}; use apenas os segmentos que precisar, nessa ordem.

• USERNAME-country-in-city-bengaluru: qualquer IP residencial em Bengaluru, um novo a cada conexão.
• USERNAME-country-id-city-surabaya: Surabaya, Java Oriental.
• USERNAME-country-vn-city-ho_chi_minh_city: Ho Chi Minh City; espaços viram sublinhados.
• USERNAME-country-au-city-gold_coast-session-gc1-ttl-15: um IP de Gold Coast mantido por 15 minutos.
• USERNAME-country-pk-city-lahore-asn-17557: Lahore na rede da PTCL (AS17557).

O código do país é o código ISO de duas letras em minúsculas. Sempre envie o país junto com a cidade: Hyderabad existe na Índia e no Paquistão, e country-pk-city-hyderabad não é o mesmo lugar que country-in-city-hyderabad.

Como escrevo cidades com dois nomes ou acentos?

Use o nome em inglês simples, sem acentos, como aparece em cada página de cidade: bengaluru, chattogram, george_town. Algumas cidades também têm um nome mais antigo, como Bangalore ou Chittagong. Se a grafia da página não retornar nenhum IP enquanto o país funciona, tente o nome mais antigo e avise o suporte, para que possamos corrigir a página. O índice de cidades lista todas as grafias que publicamos.

Como testo um IP de cidade com curl, Python e Node.js?

Envie uma requisição pelo gateway e imprima o IP de saída e o lugar que o seu serviço de consulta informa. Use um serviço de consulta que você tem permissão para chamar; os exemplos usam o endpoint público do 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));

O que acontece quando nenhum IP está online em uma cidade?

Uma cidade pequena pode ter poucos ou nenhum dispositivo residencial online em um determinado momento. Sempre confira a cidade de saída do IP que você recebe e depois:

1. Tente de novo após alguns minutos: os dispositivos residenciais ficam online e offline ao longo do dia.
2. Use uma cidade próxima da mesma página, por exemplo Rawalpindi para Islamabad.
3. Remova o segmento -city- e mantenha o país, se o trabalho permitir.

A disponibilidade de cidades varia; o checkout mostra o que está online.

Todo site vai ver a cidade que eu pedi?

Nem sempre. Os sites associam um IP ao próprio banco de dados de geolocalização, e os bancos de dados divergem, especialmente perto das fronteiras das cidades: um dispositivo residencial em Gurugram pode aparecer como Delhi, um em Petaling Jaya como Kuala Lumpur. O guia de verificação de cidade mostra como testar o banco de dados que o seu alvo usa antes de um trabalho grande.

O que devo ler em seguida?

Configure sessões com o guia de proxies residenciais fixos, copie o código do cliente na documentação e consulte termos como ASN ou CGNAT no glossário. Todos os outros guias estão listados na página de guias.