Geo-Targeting

Geo-targeting sends your requests through residential IPs in a specific country, state or city. You set it in the username of your proxy credentials.

Only country is required. State and city are optional. The more specific the location, the fewer IPs are available.

Format

Put the targeting parameters between your client ID and session ID:

Username

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

Parameter	Required	Description
`country`	Yes	Country name, for example `UnitedStates`
`state`	No	State or region inside the country
`city`	No	City inside the state

State and city values are lowercase with no spaces, for example city-newyork or state-northerndistrict.

Country

string

required

Name of the country you want to target.

Parameter

country-{COUNTRY_NAME}

Examples: country-UnitedStates, country-Israel, country-Hungary.

State or Region

string

State or region inside the selected country.

Parameter

state-{STATE_NAME}

Examples:

state-northerndistrict (Israel)
state-pestcounty (Hungary)
state-california (United States)
state-newyork (United States)

City

string

City inside the selected state.

Parameter

city-{CITY_NAME}

Examples:

city-maghar (Israel)
city-god (Hungary)
city-losangeles (United States)
city-newyork (United States)

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

Start with just the country. Add state or city only when you need them.
If you get PX1002 (no exit node available), add fallback-true or remove the city, then 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

Country

State or Region

City

Example Request

Tips

​Format

​Country

​State or Region

​City

​Example Request

​Tips

Format

Country

State or Region

City

Example Request

Tips