Headless browser

Playwright proxy setup

For JavaScript-heavy targets you need a real browser. Playwright takes a proxy object at launch, with the username and password passed separately — so an authenticated residential gateway just works, headless or headed.

Start with 1 GB free View pricing
Get 1 GB of residential data — freeon your first $10+ top-upClaim it
Endpoint

Connection details

proxmint · gateway
Host : Port (HTTP)gw.proxmint.com:823
Host : Port (SOCKS5)gw.proxmint.com:824
UsernamePROXY_USER
PasswordPROXY_PASS

Swap PROXY_USER / PROXY_PASS for the credentials on your dashboard. New here? Create an account to generate a key.

Code

Playwright proxy example

python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.proxmint.com:823",
        "username": "PROXY_USER",       # add __cr.us here to target a country
        "password": "PROXY_PASS",
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org")
    print(page.inner_text("body"))  # the residential IP the site sees
    browser.close()
Targeting

Steer the exit IP from the username

append to your username
CountryPROXY_USER__cr.us
Country + cityPROXY_USER__cr.us;city.newyork
Sticky IP (30 min)PROXY_USER__sessid.abc123;sessttl.30
Good to know

Tips & gotchas

  • Put targeting in the username field, e.g. PROXY_USER__cr.us — the server field stays host:port only.
  • Node Playwright is identical: pass { server, username, password } to browserType.launch.
FAQ

Playwright, answered

Why split the username and password in Playwright?

Chromium cannot parse credentials embedded in the proxy URL, so Playwright exposes username and password as separate fields. Keep the server value as http://host:port and put auth (and any targeting) in those fields.

Can I keep one IP for a whole browser session?

Yes — add a sticky session id to the username (PROXY_USER__sessid.abc123;sessttl.30). The browser then holds the same residential IP across navigations, which avoids re-triggering anti-bot checks.

Ready to route Playwright through residential IPs?

Create an account, paste the code above, and we'll add your first 1 GB of residential free on your first top-up. Pay by the GB after that — no subscription.

Claim your free 1 GB All integrations