The right proxy type for undetected-chromedriver
For most scraping, Residential Lite is the cheapest way to get home IP addresses in the right country. Use Residential when you need a particular state or city, and Unlimited Datacenter for targets in the United States that do not block data centre addresses.
- Residentialfrom $2.64 per GB
- Residential Litefrom $0.60 per GB
- Unlimited Datacenterfrom $0.56 per hour
The values to enter in undetected-chromedriver
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 undetected-chromedriver
- Start a local forwarder that listens without a login and passes traffic on to the proxy with your login.
- Point the browser at the forwarder with
--proxy-server.
Code: undetected-chromedriver through a proxy
Start a forwarder (gost)
gost -L=:8899 -F=http://USERNAME:PASSWORD@resi.piratproxies.com:8080Python
import undetected_chromedriver as uc
options = uc.ChromeOptions()
options.add_argument("--proxy-server=http://127.0.0.1:8899")
driver = uc.Chrome(options=options)
driver.get("https://api.ipify.org")
print(driver.find_element("tag name", "body").text)
driver.quit()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 undetected-chromedriver rotate IPs or keep one?
When undetected-chromedriver is fetching lots of unrelated pages, leave the session out of the username and each request gets a fresh IP address. When requests belong together, such as a login, a basket or paginated results that set cookies, put a session in the username so they all share one address.
Here is what a sticky username looks like:
USERNAME-country-us-time-600-session-a1b2c3d4When undetected-chromedriver will not connect
- A small local forwarder solves this: it listens on your computer without a login and adds the username and password on the way out. See proxies with a login in tools that only take IP and port.
- Run one forwarder per IP address you want. Each can carry a different session ID in its username.
- 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.
undetected-chromedriver and proxies: questions
Can undetected-chromedriver use a SOCKS5 proxy?
Only without a login: undetected-chromedriver cannot send a SOCKS5 username and password. Use the HTTP port, 8080, instead; it handles http and https sites alike.
Which PiratProxies plan suits undetected-chromedriver best?
For most scraping, Residential Lite is the cheapest way to get home IP addresses in the right country. Use Residential when you need a particular state or city, and Unlimited Datacenter for targets in the United States that do not block data centre addresses.
Words used in this guide: web scraping, rotating proxy, sticky session, rate limiting, headless browser.
undetected-chromedriver 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.