City-Targeting

City-targeting routes requests through residential IPs located in a single city — the most precise level of geo-targeting we offer. Add the city parameter to the username segment of your proxy credentials, together with the matching country and state.

City is the narrowest targeting level, so it has the smallest IP pool. Always pair city with the correct country and state — a city that doesn’t match its state returns no IPs.

Targeting Format

Add the city parameter after country and state, before your session ID:

client-{CLIENT_ID}-country-{COUNTRY}-state-{STATE}-city-{CITY}-session-{SESSION_ID}

string

required

City name that matches the selected state. Lowercase, dash-separated, no spaces or special characters.

Parameter	Required	Description
`country`	Yes	Country the city belongs to
`state`	Yes	State or region the city belongs to
`city`	No	City within the state

City names are written lowercase with spaces removed (e.g. city-newyork, city-telaviv).

Examples

City	Parameter	State	Country
Berlin	`city-berlin`	`state-landberlin`	Germany
Bremen	`city-bremen`	`state-citystatebremen`	Germany
Maghar	`city-maghar`	`state-northerndistrict`	Israel
Göd	`city-god`	`state-pestcounty`	Hungary

Example Request

import requests

proxies = {
    'http': 'http://client-{CLIENT_ID}-country-Germany-state-landberlin-city-berlin-session-fnzwtath:{PASSWORD}@residential.roundproxies.com:5000',
    'https': 'http://client-{CLIENT_ID}-country-Germany-state-landberlin-city-berlin-session-fnzwtath:{PASSWORD}@residential.roundproxies.com:5000'
}

response = requests.get('https://api.ipify.org?format=json', proxies=proxies)
print(response.json())

curl -x "http://client-{CLIENT_ID}-country-Germany-state-landberlin-city-berlin-session-fnzwtath:{PASSWORD}@residential.roundproxies.com:5000" \
  https://api.ipify.org?format=json

Tips

Only reach for city-targeting when your use case truly needs it — country or state targeting gives you a much larger IP pool.
If you receive No Available IPs for Targeting, drop the city parameter and retry with state-level targeting. See Error Handling.
Pair city-targeting with a sticky session to keep the same exit IP across requests.

Getting Started

Residential Proxies

ISP Proxies

Datacenter Proxies

Reseller

Targeting Format

Examples

Example Request

Tips

​Targeting Format

​Examples

​Example Request

​Tips

Targeting Format

Examples

Example Request

Tips