The right proxy type for Browserless
Residential proxies suit automation that acts like a visitor, with a sticky session for anything that logs in. For testing your own site from other countries, any plan with the right country works; Residential Lite is the cheapest.
The values to enter in Browserless
Every PiratProxies plan comes down to four values: host, port, username and password. Here they are for Residential; your own username and password are on your plan page.
| Host | resi.piratproxies.com |
|---|---|
| HTTP port | 8080 |
| SOCKS5 port | 1080 |
| Username | USERNAME |
| Password | shown on your plan page |
There is no separate country or session field: both are part of the username. Your plan page has a generator that writes it, and Targeting and sessions describes each piece.
Setting it up in Browserless
- Add
--proxy-serverto the connection address with the proxy host and port. - After connecting, call
page.authenticatewith your username and password.
Code: Browserless through a proxy
Node.js, with Puppeteer
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.connect({
browserWSEndpoint: 'ws://localhost:3000?--proxy-server=http://resi.piratproxies.com:8080',
});
const page = await browser.newPage();
await page.authenticate({ username: 'USERNAME', password: 'PASSWORD' });
await page.goto('https://api.ipify.org');
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();
})();Put your own login from the plan page in place of USERNAME and PASSWORD. The example calls an IP-check service, so what it prints is the address your request came from.
Should Browserless rotate IPs or keep one?
When Browserless plays one visitor across several steps, a sticky session keeps the IP address unchanged from start to finish. When every run stands alone, drop the session and each run begins from a new address.
Here is what a sticky username looks like:
USERNAME-country-us-time-600-session-a1b2c3d4When Browserless will not connect
- The launch argument is per connection, so different connections can use different proxies or session IDs.
- Error
407means the login was refused. Copy the username and password from your plan page once more, and make sure no space crept in and the username was not cut short. - An IP in the wrong country nearly always comes from the username, since the country code lives there. Other fixes.
Browserless and proxies: questions
Can Browserless use a SOCKS5 proxy?
Only without a login: Browserless cannot send a SOCKS5 username and password. Use the HTTP port, 8080, instead; it handles http and https sites alike.
Which PiratProxies plan suits Browserless best?
Residential proxies suit automation that acts like a visitor, with a sticky session for anything that logs in. For testing your own site from other countries, any plan with the right country works; Residential Lite is the cheapest.
Words used in this guide: headless browser, rotating proxy, sticky session, proxy authentication.
Browserless belongs to its own developers, and PiratProxies has no connection with them; we name it only to say what this guide covers. Follow the rules of the sites you visit and our acceptable use policy.