Integrations / Proxy setups / Residential proxies
Residential proxies, one per profile.
A residential proxy exits through a home internet connection. It only helps if the rest of the profile agrees with it: same timezone, same language, the same exit every visit. Browz checks where each proxy really exits and sets the profile to match.
import { Browz, localCredentials } from '@browz/sdk';
const browz = new Browz(await localCredentials());
const { id } = await browz.proxies.create({
name: 'Sydney residential 1', scheme: 'http', host: '203.0.113.10', port: 8080,
user: process.env.PROXY_USER, pass: process.env.PROXY_PASS,
});
console.log(await browz.proxies.check({ scheme: 'http', host: '203.0.113.10', port: 8080,
user: process.env.PROXY_USER, pass: process.env.PROXY_PASS }));
console.log(id);Setup
Set it up.
Ask your provider for sticky sessions
Residential providers usually offer rotating and sticky sessions. For a profile that signs in and comes back, use a sticky session (the same exit for minutes or hours), one per profile. The provider tells you the host, port and the username format that picks a session and a country.
Add the proxy
In Browz, open Proxies and add it, or paste a list in any common format. From code, the local API takes the same fields; read the password from the environment, not from source.
add-proxy.mjsimport { Browz, localCredentials } from '@browz/sdk'; const browz = new Browz(await localCredentials()); const { id } = await browz.proxies.create({ name: 'Sydney residential 1', scheme: 'http', host: '203.0.113.10', port: 8080, user: process.env.PROXY_USER, pass: process.env.PROXY_PASS, }); console.log(await browz.proxies.check({ scheme: 'http', host: '203.0.113.10', port: 8080, user: process.env.PROXY_USER, pass: process.env.PROXY_PASS })); console.log(id);Check where it exits
Choose Check on the proxy row. Browz opens a real tunnel and reports the exit IP, country, city and timezone. Turn on a second lookup service in Settings to compare two readings on every check.
Give it to a profile
Pick the proxy in the new-profile panel or the profile drawer, or pass
proxyIdwhen you create the profile. Leave timezone and language empty: they follow the exit.create-profile.mjsconst profile = await browz.profiles.create({ name: 'Shop – Sydney', proxyId: id });
Example
Three profiles, three sticky sessions.
Many providers pick a sticky session from the username. Save one pool proxy per session and give each profile its own, so no two profiles share an exit.
import { Browz, localCredentials } from '@browz/sdk';
const browz = new Browz(await localCredentials());
for (const n of [1, 2, 3]) {
const { id: proxyId } = await browz.proxies.create({
name: `Sydney residential ${n}`, scheme: 'http', host: '203.0.113.10', port: 8080,
user: `${process.env.PROXY_USER}-session-${n}`, // your provider’s session format
pass: process.env.PROXY_PASS,
});
const profile = await browz.profiles.create({ name: `Shop – Sydney ${n}`, proxyId });
console.log(profile.name, profile.id);
}The -session- suffix is only an example; use the exact username format your provider documents.
Good to know
Notes and tips.
- Leave a profile’s timezone, language and WebRTC on automatic: Browz sets them from where the proxy really exits, measured at each check, so the profile does not contradict its own address.
- A residential sticky session lasts as long as the provider keeps it. When it ends, the next check shows a new exit; turn on Refuse if the exit country changed in Settings to stop a profile starting from another country.
- Bring proxies from any provider: Browz supports HTTP, HTTPS, SOCKS4, SOCKS5 and SSH.
- A profile whose proxy fails its exit check is refused at Start. It never falls back to your own connection.
- A proxy changes where a profile connects from, not what a site allows. Use each site only as its terms allow; our acceptable use policy applies whatever the exit.
FAQ
Residential proxies and Browz.
Can several profiles share one residential proxy?
They can, but they then share an exit IP, which links them. Give each profile its own sticky session unless sharing is what you want.
Which protocol should I pick?
Whatever your provider offers: HTTP, HTTPS, SOCKS4, SOCKS5 and SSH all work. Only HTTPS and SSH encrypt the hop between your computer and the proxy, credentials included.
Does Browz sell residential proxies?
No. Bring them from any provider.
What if the exit moves to another city?
The next check records it, and the profile’s timezone follows. Only a country change can stop a launch, and only with that setting on.
Get started
Download Browz. Every task, its own browser.
curl -fsSL https://gobrowz.com/agents/install.sh | sh