Puppeteer · PROXY SETUP

Puppeteer proxy setup

Headless Chrome driver for Node. Point it at the Eveses residential pool with the configuration below — the geo lives in the username, so nothing else in your setup has to change to move country.

proxy.eveses.com:12321 · SOCKS5 on 32325 · 199 countries · from $7.35/GB

Get proxies →All integrations
Watch out

The proxy is a launch argument, but the credentials are not: `page.authenticate()` has to be called on every new page, before the first navigation. A page opened by `target=_blank` gets none of it.

Configuration

import puppeteer from "puppeteer";

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://proxy.eveses.com:12321"],
});

const page = await browser.newPage();
// Per PAGE, not per browser — and before goto().
await page.authenticate({
  username: "eveses_user_country-de",
  password: "YOUR_PROXY_PASSWORD",
});

await page.goto("https://target-site.com");

Change country without touching Puppeteer

Germanyeveses_user_country-de
Sticky 30 mineveses_user_country-de_session-ab12cd34_lifetime-30m

The geo and the session live in the username, not in the host or the port. Every configuration on this page stays exactly as it is when you move country — you edit one string. 199 countries are addressable, with city and state tokens inside most of them.

FAQ

How do I set a proxy in Puppeteer?›
Point it at proxy.eveses.com on port 12321 for HTTP, or 32325 for SOCKS5, and authenticate with your Eveses proxy username and password. The exact syntax is in the snippet above. The proxy is a launch argument, but the credentials are not: `page.authenticate()` has to be called on every new page, before the first navigation. A page opened by `target=_blank` gets none of it.
How do I choose the country Puppeteer exits from?›
Append a geo token to the USERNAME rather than changing the host: eveses_user_country-de reaches Germany, eveses_user_country-us the United States. 199 countries are addressable this way, and city or state tokens narrow it further. Nothing else in your Puppeteer configuration changes.
How do I keep the same IP across requests in Puppeteer?›
Add a session token — eveses_user_country-us_session-ab12cd34_lifetime-30m — and every request carrying that username exits from the same address until the lifetime runs out. Drop the token and each request rotates to a fresh IP.
What does this cost?›
Residential traffic is billed by the gigabyte from your Eveses wallet: $7.35/GB at 1 GB, falling to $2.57/GB in volume. There is no per-tool charge, and the same credentials work in every tool at once.
Paste your own curl → get it in javascript →

Other integrations

ScrapySeleniumPlaywrightPython requestsHTTPXaiohttpAxiosnode-fetch / undiciGuzzlecURL

Run Puppeteer through residential IPs

$7.35/GB at 1 GB, $2.57/GB in volume — same credentials in every tool.

Get proxies →