# Proxy with a specific city IP: the city parameter

> How to get a proxy with a specific city IP in Asia and Oceania: add -city-<name> to the username. Every plan, no surcharge, from $1.88 per GB. No KYC.

- URL: https://banyanproxies.com/targeting/city/
- Last updated: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

One username segment picks the city. This page gives the exact format, tested examples in curl, Python and Node.js, and what to do when a city has no IP online.

**Quick answer — How do I get a proxy with a specific city IP in Asia?**

With Banyan Proxies, add `-city-` and the city name to the proxy username after the country, for example `USERNAME-country-in-city-mumbai` or `USERNAME-country-ph-city-cebu_city`. City targeting is part of every plan at no surcharge, from $1.88 for 1 GB (October 2026). City availability varies; the checkout shows what is online. No KYC, crypto only.

## What does city targeting include?

| Attribute | Value |
| --- | --- |
| Targeting levels | Country and city targeting on every plan; ASN targeting at no extra cost. City availability varies |
| Username format | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| City names | Lowercase English name, underscores for spaces: `kuala_lumpur`, `ho_chi_minh_city`, `gold_coast` |
| Included on | Every residential plan, from 1 GB at $1.88 |
| Gateway | `gw.banyanproxies.com`, port 7777 (HTTP/HTTPS) or 7778 (SOCKS5) |
| Sticky sessions | up to 30 minutes (the IP can change earlier) |
| Availability | City availability varies; the checkout shows what is online |
| Updated | 18 October 2026 |

## 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](https://banyanproxies.com/cities/) 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.

*curl: a rotating and a sticky Jakarta IP*

```bash
# 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
```

*Python (requests): one request per city*

```python
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)
```

*Node.js 18+ (undici ProxyAgent): one Manila IP*

```javascript
// 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](https://banyanproxies.com/guides/verify-proxy-city/) shows how to test the database your target uses before a large job.

## Which cities can I target?

Each of the 70 city pages gives the exact parameter, local ISPs and time zone.

- [Mumbai](https://banyanproxies.com/residential-proxies/mumbai/) — Maharashtra
- [Delhi](https://banyanproxies.com/residential-proxies/delhi/) — National Capital Territory of Delhi
- [Bengaluru](https://banyanproxies.com/residential-proxies/bengaluru/) — Karnataka
- [Hyderabad](https://banyanproxies.com/residential-proxies/hyderabad/) — Telangana
- [Chennai](https://banyanproxies.com/residential-proxies/chennai/) — Tamil Nadu
- [Kolkata](https://banyanproxies.com/residential-proxies/kolkata/) — West Bengal
- [Pune](https://banyanproxies.com/residential-proxies/pune/) — Maharashtra
- [Ahmedabad](https://banyanproxies.com/residential-proxies/ahmedabad/) — Gujarat
- [Jaipur](https://banyanproxies.com/residential-proxies/jaipur/) — Rajasthan
- [Surat](https://banyanproxies.com/residential-proxies/surat/) — Gujarat
- [Lucknow](https://banyanproxies.com/residential-proxies/lucknow/) — Uttar Pradesh
- [Kochi](https://banyanproxies.com/residential-proxies/kochi/) — Kerala
- [Chandigarh](https://banyanproxies.com/residential-proxies/chandigarh/) — Chandigarh
- [Indore](https://banyanproxies.com/residential-proxies/indore/) — Madhya Pradesh
- [Jakarta](https://banyanproxies.com/residential-proxies/jakarta/) — Jakarta Special Capital Region
- [Surabaya](https://banyanproxies.com/residential-proxies/surabaya/) — East Java
- [Bandung](https://banyanproxies.com/residential-proxies/bandung/) — West Java
- [Medan](https://banyanproxies.com/residential-proxies/medan/) — North Sumatra
- [Semarang](https://banyanproxies.com/residential-proxies/semarang/) — Central Java
- [Makassar](https://banyanproxies.com/residential-proxies/makassar/) — South Sulawesi
- [Denpasar](https://banyanproxies.com/residential-proxies/denpasar/) — Bali
- [Yogyakarta](https://banyanproxies.com/residential-proxies/yogyakarta/) — Special Region of Yogyakarta
- [Manila](https://banyanproxies.com/residential-proxies/manila/) — Metro Manila
- [Quezon City](https://banyanproxies.com/residential-proxies/quezon-city/) — Metro Manila
- [Makati](https://banyanproxies.com/residential-proxies/makati/) — Metro Manila
- [Cebu City](https://banyanproxies.com/residential-proxies/cebu-city/) — Central Visayas
- [Davao City](https://banyanproxies.com/residential-proxies/davao-city/) — Davao Region
- [Bangkok](https://banyanproxies.com/residential-proxies/bangkok/) — Bangkok Metropolitan Administration
- [Chiang Mai](https://banyanproxies.com/residential-proxies/chiang-mai/) — Chiang Mai city municipality , Mueang Chiang Mai district, Chiang Mai province
- [Phuket](https://banyanproxies.com/residential-proxies/phuket/) — Phuket province
- [Pattaya](https://banyanproxies.com/residential-proxies/pattaya/) — Pattaya City , Bang Lamung district, Chonburi province
- [Khon Kaen](https://banyanproxies.com/residential-proxies/khon-kaen/) — Khon Kaen city municipality, Mueang Khon Kaen district, Khon Kaen province
- [Ho Chi Minh City](https://banyanproxies.com/residential-proxies/ho-chi-minh-city/) — Ho Chi Minh City
- [Hanoi](https://banyanproxies.com/residential-proxies/hanoi/) — Hanoi
- [Da Nang](https://banyanproxies.com/residential-proxies/da-nang/) — Da Nang
- [Hai Phong](https://banyanproxies.com/residential-proxies/hai-phong/) — Hai Phong
- [Can Tho](https://banyanproxies.com/residential-proxies/can-tho/) — Can Tho
- [Kuala Lumpur](https://banyanproxies.com/residential-proxies/kuala-lumpur/) — Federal Territory of Kuala Lumpur
- [George Town](https://banyanproxies.com/residential-proxies/george-town/) — Penang
- [Johor Bahru](https://banyanproxies.com/residential-proxies/johor-bahru/) — Johor
- [Shah Alam](https://banyanproxies.com/residential-proxies/shah-alam/) — Selangor
- [Kota Kinabalu](https://banyanproxies.com/residential-proxies/kota-kinabalu/) — Sabah
- [Karachi](https://banyanproxies.com/residential-proxies/karachi/) — Karachi Division, Sindh province
- [Lahore](https://banyanproxies.com/residential-proxies/lahore/) — Lahore District, Punjab province
- [Islamabad](https://banyanproxies.com/residential-proxies/islamabad/) — Islamabad Capital Territory
- [Rawalpindi](https://banyanproxies.com/residential-proxies/rawalpindi/) — Rawalpindi District, Punjab province
- [Faisalabad](https://banyanproxies.com/residential-proxies/faisalabad/) — Faisalabad District, Punjab province
- [Peshawar](https://banyanproxies.com/residential-proxies/peshawar/) — Peshawar District, Khyber Pakhtunkhwa province
- [Dhaka](https://banyanproxies.com/residential-proxies/dhaka/) — Dhaka Division
- [Chittagong](https://banyanproxies.com/residential-proxies/chittagong/) — Chittagong Division, Chittagong District
- [Khulna](https://banyanproxies.com/residential-proxies/khulna/) — Khulna Division, Khulna District
- [Colombo](https://banyanproxies.com/residential-proxies/colombo/) — Western Province, Colombo District
- [Kandy](https://banyanproxies.com/residential-proxies/kandy/) — Central Province, Kandy District
- [Kathmandu](https://banyanproxies.com/residential-proxies/kathmandu/) — Bagmati Province, Kathmandu District
- [Pokhara](https://banyanproxies.com/residential-proxies/pokhara/) — Gandaki Province, Kaski District
- [Phnom Penh](https://banyanproxies.com/residential-proxies/phnom-penh/) — Phnom Penh Capital
- [Siem Reap](https://banyanproxies.com/residential-proxies/siem-reap/) — Siem Reap municipality , Siem Reap province
- [Singapore](https://banyanproxies.com/residential-proxies/singapore/) — Republic of Singapore (city-state
- [Sydney](https://banyanproxies.com/residential-proxies/sydney/) — New South Wales
- [Melbourne](https://banyanproxies.com/residential-proxies/melbourne/) — Victoria
- [Brisbane](https://banyanproxies.com/residential-proxies/brisbane/) — Queensland
- [Perth](https://banyanproxies.com/residential-proxies/perth/) — Western Australia
- [Adelaide](https://banyanproxies.com/residential-proxies/adelaide/) — South Australia
- [Gold Coast](https://banyanproxies.com/residential-proxies/gold-coast/) — Queensland
- [Canberra](https://banyanproxies.com/residential-proxies/canberra/) — Australian Capital Territory
- [Hobart](https://banyanproxies.com/residential-proxies/hobart/) — Tasmania
- [Auckland](https://banyanproxies.com/residential-proxies/auckland/) — Auckland Region
- [Wellington](https://banyanproxies.com/residential-proxies/wellington/) — Wellington Region
- [Christchurch](https://banyanproxies.com/residential-proxies/christchurch/) — Canterbury Region
- [Hamilton](https://banyanproxies.com/residential-proxies/hamilton/) — Waikato Region

## What should I read next?

Set sessions with the [sticky residential proxies guide](https://banyanproxies.com/guides/sticky-sessions/), copy client code from the [docs](https://banyanproxies.com/docs/), and look up terms such as ASN or CGNAT in the [glossary](https://banyanproxies.com/glossary/). Every other guide is listed on the [guides page](https://banyanproxies.com/guides/).

## What else do buyers ask about city targeting?

### Does city targeting cost extra?

No. City targeting is included on every Banyan Proxies residential plan, from $1.88 for 1 GB to $0.50/GB on 1 TB. By comparison, DataImpulse documents that city-targeted traffic is billed at double its standard rate (read on 18 October 2026).

### Can I target a postcode or a district?

No. Targeting stops at the city. Postcodes are still useful inside the target site, for example to set a delivery address on a marketplace after the page loads from the right city.

### Can I combine city and ASN?

Yes: `USERNAME-country-my-city-kuala_lumpur-asn-4788` asks for a Kuala Lumpur IP on TM's network. Each filter shrinks the set of matching IPs, so test before you scale. See [ASN targeting](https://banyanproxies.com/targeting/asn/).

### How long can I keep one city IP?

Sticky sessions keep the same IP for the time you set (ttl, in minutes), up to 30 minutes. The IP can change earlier, for example if the residential device goes offline. Add `-session-<id>-ttl-<minutes>` after the city segment.

### Is there a city that you do not cover?

Only the 70 cities with a page are documented, but the parameter accepts other cities in the same 14 countries. City availability varies; the checkout shows what is online. East Asia and mainland China are not covered.

**Pick a city, pay in crypto** City targeting on every plan from $1.88. No KYC: no ID, no selfie, no documents. [See pricing](https://banyanproxies.com/pricing/)

## Where do these facts come from?

1. [DataImpulse city parameter (city traffic billed at double the standard rate)](https://docs.dataimpulse.com/proxies/parameters/city.md) — DataImpulse (2026-10-18)
2. [undici ProxyAgent documentation](https://undici.nodejs.org/#/docs/api/ProxyAgent) — Node.js undici
3. [ipinfo.io API](https://ipinfo.io/developers) — IPinfo

---

Banyan Proxies: Banyan Proxies is a residential proxy provider for cities across South and Southeast Asia and Oceania, paid in crypto with no ID upload: home IPs targeted by city in Mumbai, Jakarta, Manila, Bangkok, Karachi, Sydney and more, billed per GB.