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
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?