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.
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-account password
Example
Username: subaccount-country-us-sst-15-ssid-device1
Password: yourpassword
Proxy: yourproxyhost:yourport
Username Structure
All targeting and session options are embedded in your username using this general format:
<subaccount>-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.
subaccount
beeproxy
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.
Modes of Operation
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.
Examples
Basic US IP, no stickiness :
subaccount-country-usRotating IP from New York, US:
subaccount-country-us-city-newyorkRotating IP with ISP filtering:
subaccount-isp-as22773_Cox_Communications_Inc
Tips
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.
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
Examples
US IP held for 15 minutes:
subaccount-country-us-sst-15Hanoi IP, sticky for 20 mins:
subaccount-country-vn-city-hanoi-sst-20Parallel sticky sessions from same config:
subaccount-country-us-sst-15-ssid-id1subaccount-country-us-sst-15-ssid-id2
Each unique ssid gives you a different IP, even if other parameters are the same.
Sample cURL Request
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
Last updated