Skip to main content
Roundproxies residential proxies provide access to a global network of residential IP addresses with advanced targeting capabilities. Our proxies support country, state, and city-level targeting, along with session management for consistent IP addresses.
This is a developer guide: For easy and fast proxy creation head over to your Residential dashboard and create proxies there. Here is the dashboard link: https://app.roundproxies.com/dashboard/residential
Intro Residentials Pn

​
Proxy Structure

Our residential proxies follow a standardized format that allows precise geographic targeting and session control: 
residential.roundproxies.com:5000:client-CLIENT_ID-TARGETING_PARAMS-session-SESSION_ID:PASSWORD

​
Components Breakdown

ComponentDescriptionExample
HostProxy server hostnameresidential.roundproxies.com
PortConnection port5000
Client IDYour unique client identifierclient-{YOUR_CLIENT_NAME}
TargetingGeographic targeting parameterscountry-Israel-state-northerndistrict-city-maghar
SessionSession identifier for IP persistencesession-lw515ejc
PasswordAuthentication passwordYOUR_PASSWORD

​
Geographic Targeting

Keep in mind that you only need to have the country parameter for your proxies. Other parameters are optional and can be enabled on-demand. However, the more specific you chose the region the more the chance might be that the region has less proxies.

​
Country Targeting

​
country
string
required
Country name of the country you would like to target.
Target specific countries by including the country parameter in your proxy credentials: 
country-{COUNTRY_NAME}
Available countries in examples:
  • Israel
  • Hungary
  • Germany

​
State/Region Targeting

​
state
string
State name of the state (mathching the country) you would like to target.
Narrow down to specific states or regions: 
state-{STATE_NAME}
Examples:
  • state-northerndistrict (Israel)
  • state-pestcounty (Hungary)
  • state-citystatebremen (Germany)
  • state-landberlin (Germany)

​
City Targeting

​
city
string
City name that is supported and matches the state of the proxy.
Target specific cities for maximum precision: 
city-{CITY_NAME}
Examples:
  • city-maghar (Israel)
  • city-god (Hungary)
  • city-bremen (Germany)
  • city-berlin (Germany)