Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.roundproxies.com/llms.txt

Use this file to discover all available pages before exploring further.

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}
ParameterRequiredDescription
countryYesCountry name (e.g. Germany, Israel)
stateNoState or region within the country
cityNoCity within the state
Values are lowercase, dash-separated, with no spaces or special characters (e.g. city-newyork, state-northerndistrict).

​
Country Targeting

​
country
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

​
state
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

​
city
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())

​
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.