Gleam Residential Proxy User Guide
This guide explains how to generate, configure, test, and use Gleam Residential Proxies. Select a target IP location, configure rotating or sticky sessions, generate proxy credentials, and use them in browsers, proxy tools, or code.
Quick Start
You can start using Gleam Residential Proxies in four steps.
Purchase proxy traffic
Make sure your account has valid residential proxy traffic.
Open Proxy Generator
Open Proxy Generator under Residential Proxies.
Configure parameters
Set the target location, session type, and gateway.
Generate and use
Copy the generated proxy details into your tool or application.
Before You Start
Confirm that your account has available, unexpired residential proxy traffic; you have your proxy username and password; and you know the target country or region required for your task.
Step 1: Open Proxy Generator
The Proxy Generator creates ready-to-use proxy credentials based on your selected location and session settings.
Sign in to the console
Sign in with your registered Gleam account.
Open Residential Proxies
Open the Residential Proxies page.
View Proxy Generator
Review the account, traffic, port, and gateway details.
Step 2: Configure Your Proxy
Configure the proxy username, password, target location, session type, gateway, quantity, and output format.
| Setting | Description |
|---|---|
| Username | Generated proxy authentication username. |
| Password | Proxy authentication password. |
| Country / Region | Select the target exit location. |
| Session Type | Choose Rotating or Sticky. |
| Gateway / Port | Select a gateway and use the assigned port. |
| Output Format | Select a format supported by your client. |
Configure Location and Session Parameters
Gleam encodes location and sticky-session settings in the generated proxy username.
-A-
-T-
-C-
YOUR_USERNAME-A-US-T-10m-C-ad9an023
United States, a 10-minute sticky session, and a custom session identifier.
Rotating Session
A new proxy IP may be assigned for each request or connection.
- Public data collection
- Price monitoring
- Large numbers of independent requests
Sticky Session Recommended
Keeps the same proxy IP for the selected duration when available.
- Short verification: 5-10 minutes
- Multi-page browsing: 10-30 minutes
- Authorized workflow: 30-60 minutes
Step 3: Choose a Proxy Address
Choose the gateway closest to your target resource for better connection performance.
tun-hk.ipgleam.net
Recommended for proxy IP resources in Asia and Africa.
tun-us.ipgleam.net
Recommended for proxy IP resources in the Americas, Europe, and Oceania.
The proxy address determines how requests enter the Gleam proxy network. It does not limit the country or region of the proxy IP you can select.
Step 4: Generate Proxy Details
Select a quantity and output format, generate the proxy, then copy one or all results.
tun-hk.ipgleam.net:10000:USERNAME:PASSWORD
http://USERNAME:PASSWORD@tun-hk.ipgleam.net:10000
https://USERNAME:PASSWORD@tun-hk.ipgleam.net:10000
socks5://USERNAME:PASSWORD@tun-hk.ipgleam.net:10000
How to Use Your Proxy
Configure Gleam Residential Proxies in browsers, proxy tools, or application code.
curl -x http://tun-hk.ipgleam.net:10000 \ -U "YOUR_USERNAME-A-US-T-10m-C-session123:YOUR_PASSWORD" \ https://api.ipify.org
import requests
proxy_url = "http://YOUR_USERNAME:YOUR_PASSWORD@tun-hk.ipgleam.net:10000"
response = requests.get("https://api.ipify.org?format=json", proxies={"http": proxy_url, "https": proxy_url}, timeout=30)
print(response.json())
const { HttpsProxyAgent } = require("https-proxy-agent");
const proxyUrl = "http://YOUR_USERNAME:YOUR_PASSWORD@tun-hk.ipgleam.net:10000";
axios.get("https://api.ipify.org?format=json", { httpsAgent: new HttpsProxyAgent(proxyUrl), proxy: false });
const browser = await chromium.launch({
proxy: { server: "http://tun-hk.ipgleam.net:10000", username: "YOUR_USERNAME", password: "YOUR_PASSWORD" }
});
Verify Your Proxy Connection
Test a proxy before running a large or production task.
The request completes successfully.
Your real IP is replaced by a proxy IP.
The location matches the selected target.
The IP remains stable during the selected duration.
Authentication Methods
Username and Password Authentication
Recommended when server IPs change, you use cloud servers or multiple devices, need location or session parameters, or use automation tools and scripts.
IP Whitelist Authentication
A fixed public IP can connect without username and password after it is added to the whitelist. Update the whitelist before reconnecting when the server public IP changes.
Troubleshooting
Expand an issue to review possible causes and recommended actions.
- Copy the proxy username and password again from the console.
- Confirm the authentication method you are using.
- When using an IP whitelist, confirm the server public IP has been added.
- Check the proxy address and assigned port.
- Choose a gateway close to the target resource.
- Test the connection with the cURL example.
-C- session identifier throughout the workflow.Still unable to connect after completing the checks?
Contact Gleam Support and provide your registered email, issue time, gateway address, assigned port, protocol, error message or screenshot, and current authentication method. Do not provide your full proxy password.
