City-Targeting

City-targeting sends your requests through residential IPs in one city. It is the most precise location option. Add city to your username together with the matching country and state.

City has the smallest IP pool of any location option. Always use the correct country and state with it. A city that doesn’t match its state returns no IPs.

Format

Put city after country and state, before your session ID:

Username

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

string

required

City inside the selected state. Lowercase, no spaces or special characters.

Parameter	Required	Description
`country`	Yes	Country the city is in
`state`	Yes	State or region the city is in
`city`	No	City inside the state

Write city names in lowercase without spaces, for example city-newyork or city-telaviv.

Examples

City	Parameter	State	Country
Los Angeles	`city-losangeles`	`state-california`	United States
New York	`city-newyork`	`state-newyork`	United States
Maghar	`city-maghar`	`state-northerndistrict`	Israel
Göd	`city-god`	`state-pestcounty`	Hungary

Example Request

Python
cURL

Python

import requests

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

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

cURL

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

Tips

Only use city-targeting when you really need it. Country or state targeting gives you far more IPs.
If you get PX1002 (no exit node available), add fallback-true to accept another city in the same country, or remove city and target the state. See Error Handling.
Add a session to keep the same IP across requests.

Getting Started

Residential Proxies

ISP Proxies

Datacenter Proxies

Reseller

Format

Examples

Example Request

Tips

​Format

​Examples

​Example Request

​Tips

Format

Examples

Example Request

Tips