Making Requests
Our Residential Proxies support flexible IP targeting, random or sticky sessions, and custom ISP filtering - all controlled through a structured username. Once you understand the format, you can easily generate powerful, targeted proxy sessions without needing extra setup.
1. Proxy Access Components
You’ll need:
Hostname: Fixed - provided in your dashboard
Port: Fixed - provided in your dashboard
Username: Structured with targeting options (see below)
Password: Your sub-user password
Example:
Username: subaccount-country-us-sst-15-ssid-device1
Password: your_password
Proxy: your_proxy_host:your_port
1.1. Username Structure
All targeting and session options are embedded in your username using this general format:
<sub-user’s username>-country-<country_code>-st-<state_code>-city-<city_name>-isp-<isp_code>-sst-<session_time>-ssid-<session_id>
Note: Not all parameters are required. You can mix and match the parameters depending on your use case - whether you're using rotating IPs, sticky sessions, or both. See use cases below.
Sub-user’s username
9proxy
Your unique sub-account name. This is used to identify your proxy session and is issued in your account dashboard.
country
country-us
Specifies the target country using a two-letter country code. In this example, traffic is routed through the United States.
st
st-ohio
(Optional) Adds a filter by state or region. Helps narrow IP selection to a specific area within the country.
city
city-newyork
(Optional) Adds city-level targeting to improve geo-accuracy. Use underscores for cities with spaces.
isp
isp-as22773_Cox_Communications_Inc.
(Optional) Filters IPs based on ISP name or ASN. Useful for advanced fingerprint matching or ISP-specific use cases.
sst
sst-15
Required for sticky sessions. Sets how long (in minutes) the IP stays fixed before rotating (e.g. 15 minutes).
ssid
ssid-ID1
(Optional, but recommended for parallel use) Defines a unique session ID to allow multiple sticky IPs from the same config.
1.2. Modes of Operation
1.2.1. Rotating IP Mode (Random)
Each request gets a fresh IP. You don’t need to specify sst or ssid.
Use When: Speed is more important than continuity — e.g., scraping, price monitoring.
Example
# Basic US IP, no stickiness
subaccount-country-us
# Rotating IP from New York, US
subaccount-country-us-city-newyork
# Rotating IP with ISP filtering
subaccount-isp-as22773_Cox_Communications_Inc.
Tip: For fastest response, target only by country. Adding city/state/ISP narrows the IP pool. Avoid over-filtering with state + city + isp unless necessary - this can limit IP availability.
1.2.2. Sticky IP Mode
Keeps the same IP for a session of sst minutes. Optional ssid lets you create multiple sticky IPs from the same configuration.
Use When: You need IP persistence — e.g., logging into accounts, managing sessions, or running bots.
Required:
sst: Session duration (in minutes)
Optional: ssid: Unique session ID to get multiple IPs under same config
Example
# US IP held for 15 minutes
subaccount-country-us-sst-15
# Hanoi IP, sticky for 20 mins
subaccount-country-vn-city-hanoi-sst-20
# Parallel sticky sessions from same config
subaccount-country-us-sst-15-ssid-id1
subaccount-country-us-sst-15-ssid-id2
Each unique ssid gives you a different IP, even if other parameters are the same.
2. Sample cURL Request
// example
curl -x yourproxyhost:yourport \
-U "subuser-country-us-sst-15-ssid-bot01:yourpassword" \
https://ipinfo.io
3. Choose the Right Setup
Fastest random IPs
country
No sst, no ssid
Geolocated rotating IPs
country, city/isp
Optional state, city, isp
Sticky sessions (single device)
country, sst
Keeps IP fixed during session time
Sticky across devices/apps
country, sst, ssid
Use different ssid per instance
Email: [email protected]
Live Chat: Available on 9proxy.com
Telegram: @Official9Proxy
Last updated
Was this helpful?