Headless browser

Selenium proxy setup

Vanilla Selenium cannot handle username/password proxies, so the clean path is selenium-wire, which injects the credentials for you. Point it at your gateway and Chrome drives through residential IPs.

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

Selenium proxy example

python
# pip install selenium-wire selenium
from seleniumwire import webdriver

proxy = "http://PROXY_USER:PROXY_PASS@gw.proxmint.com:823"  # add __cr.us in the user for a country
options = {
    "proxy": {
        "http": proxy,
        "https": proxy,
        "no_proxy": "localhost,127.0.0.1",
    }
}

driver = webdriver.Chrome(seleniumwire_options=options)
driver.get("https://api.ipify.org")
print(driver.find_element("tag name", "body").text)
driver.quit()
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

  • Plain selenium cannot inject proxy auth — selenium-wire is the standard workaround.
  • For a stable IP through a multi-step journey, use a sticky session id in the username.
FAQ

Selenium, answered

Why does Selenium ignore my proxy credentials?

The Chrome/Firefox WebDriver has no API for authenticated proxies. selenium-wire intercepts the connection and supplies the username and password, which is why the example uses seleniumwire_options.

Can I geo-target with Selenium?

Yes — put the targeting in the username, e.g. PROXY_USER__cr.us;city.chicago. selenium-wire passes it straight through to the gateway.

Ready to route Selenium 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