Proxy with a specific city IP: the city parameter

How is the city username built?

The username is a chain of segments joined by hyphens. The full format is USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}; use only the segments you need, in that order.

• USERNAME-country-in-city-bengaluru: any home IP in Bengaluru, a new one on each connection.
• USERNAME-country-id-city-surabaya: Surabaya, East Java.
• USERNAME-country-vn-city-ho_chi_minh_city: Ho Chi Minh City; spaces become underscores.
• USERNAME-country-au-city-gold_coast-session-gc1-ttl-15: one Gold Coast IP kept for 15 minutes.
• USERNAME-country-pk-city-lahore-asn-17557: Lahore on PTCL's network (AS17557).

The country code is the two-letter ISO code in lowercase. Always send the country with the city: Hyderabad exists in India and in Pakistan, and country-pk-city-hyderabad is not the same place as country-in-city-hyderabad.

How do I write cities with two names or accents?

Use the plain English name without accents, as shown on each city page: bengaluru, chattogram, george_town. Some cities also have an older name, such as Bangalore or Chittagong. If the spelling on the page returns no IP while the country works, try the older name and tell support, so we can correct the page. The city index lists every spelling we publish.

How do I test a city IP with curl, Python and Node.js?

Send one request through the gateway and print the exit IP and the place your lookup service reports. Use a lookup service you are allowed to call; the examples use ipinfo.io's public endpoint.

# 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));

What happens when no IP is online in a city?

A small city may have few or no home devices online at a given moment. Always check the exit city of the IP you receive, then:

1. Retry after a few minutes: home devices go on and off line through the day.
2. Use a nearby city from the same page, for example Rawalpindi for Islamabad.
3. Drop the -city- segment and keep the country, if the job allows it.

City availability varies; the checkout shows what is online.

Will every website see the city I asked for?

Not always. Websites place an IP with their own geolocation database, and databases disagree, especially near city borders: a Gurugram home may show as Delhi, a Petaling Jaya home as Kuala Lumpur. The city check guide shows how to test the database your target uses before a large job.

What should I read next?

Set sessions with the sticky residential proxies guide, copy client code from the docs, and look up terms such as ASN or CGNAT in the glossary. Every other guide is listed on the guides page.