Geo-Targeting

Geo-targeting lets you route requests through residential IPs in a specific country, region, or city. Add the targeting parameters to the username segment of your proxy credentials.

Only the country parameter is required for geo-targeting. State and city are optional refinements — the more specific the target, the smaller the available IP pool.

Targeting Format

Add targeting parameters between your client ID and session ID:

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

Parameter	Required	Description
`country`	Yes	Country name (e.g. `Germany`, `Israel`)
`state`	No	State or region within the country
`city`	No	City within the state

Values are lowercase, dash-separated, with no spaces or special characters (e.g. city-newyork, state-northerndistrict).

Country Targeting

string

required

Country name of the country you would like to target.

country-{COUNTRY_NAME}

Examples:

country-Germany
country-Israel
country-Hungary

State / Region Targeting

string

State or region name that matches the selected country.

state-{STATE_NAME}

Examples:

state-northerndistrict (Israel)
state-pestcounty (Hungary)
state-citystatebremen (Germany)
state-landberlin (Germany)

City Targeting

string

City name that matches the selected state.

city-{CITY_NAME}

Examples:

city-maghar (Israel)
city-god (Hungary)
city-bremen (Germany)
city-berlin (Germany)

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

Start with country only and add state/city only if your use case demands it.
If you receive No Available IPs for Targeting, drop the city first, then the state. See Error Handling.
Pair geo-targeting with a sticky session to keep the same exit IP across requests.

Getting Started

Residential Proxies

Datacenter Proxies

Targeting Format

Country Targeting

State / Region Targeting

City Targeting

Example Request

Tips

​Targeting Format

​Country Targeting

​State / Region Targeting

​City Targeting

​Example Request

​Tips

Targeting Format

Country Targeting

State / Region Targeting

City Targeting

Example Request

Tips