Proxy locations


North America

South America




See all locations

Network statusCareers

Selenium Proxy Integration with Oxylabs

Selenium is a tool that helps automate web browser interactions for website testing and more. It’s useful when you need to interact with a browser to perform a number of tasks, such as clicking on buttons, scrolling, etc. Even if Selenium is primarily used for website testing, it can also be used for web scraping as it helps locate the required public data on a website.

This guide will go through the Selenium integration process with Oxylabs Residential and Datacenter Proxies using Python and Java for a smooth web scraping process.

Selenium Proxy Integration with Oxylabs

How to integrate proxies with Selenium using Python?

The following explains how to set up Oxylabs proxies with Selenium in Python. Note that the required version of Python is Python 3.5 (or newer).

Setting up Selenium

Using the default Selenium module for implementing proxies that require authentication makes the whole process complicated. To make it less complex, install Selenium Wire to extend Selenium’s Python bindings. You can do it using the pip command:

pip install selenium-wire

Another recommended package for this integration is Selenium webdriver-manager. It simplifies the management of binary drivers for different browsers. In this case, there’s no need to manually download a new version of a web driver after each update.

You can install the Selenium webdriver-manager using the pip command as well:

pip install webdriver-manager

Proxy authentication

Once everything is set up, you can move on to the next part – proxy authentication. For proxies to work, you’ll be prompted to specify your account credentials and an endpoint.

Here are the endpoints for Oxylabs proxies (host:port):

Residential Proxies:

Dedicated Datacenter Proxies: (a specific IP address)

Shared Datacenter Proxies:

USERNAME = "your_username"
PASSWORD = "your_password"

You’ll need to adjust your_username and your_password fields with the username and password of your Oxylabs proxy user.

You can also use country-specific entries. For example, if you put under Host and 10000 under Port, you'll receive a residential US exit node.

For Oxylabs proxy customization options – such as country-specific entry points – refer to Shared DatacenterDedicated Datacenter, and Residential Proxies documentations, respectively.

Testing proxy server connection

To check if the proxy is working, visit If everything is working correctly, it will return an IP address of a proxy that you’re using.

    return f'\nYour IP is: {"[0-9].{2,}", driver.page_source).group()}'

Full Python code for Oxylabs proxies integration with Selenium

import re
from typing import Optional

from seleniumwire import webdriver
from import Service
# A package to have a chromedriver always up-to-date.
from import ChromeDriverManager

USERNAME = "your_username"
PASSWORD = "your_password"

def chrome_proxy(user: str, password: str, endpoint: str) -> dict:
    wire_options = {
        "proxy": {
            "http": f"http://{user}:{password}@{endpoint}",
            "https": f"http://{user}:{password}@{endpoint}",

    return wire_options

def get_ip_via_chrome():
    manage_driver = Service(executable_path=ChromeDriverManager().install())
    options = webdriver.ChromeOptions()
    options.headless = True
    proxies = chrome_proxy(USERNAME, PASSWORD, ENDPOINT)
    driver = webdriver.Chrome(
        service=manage_driver, options=options, seleniumwire_options=proxies
        return f'\nYour IP is: {"[0-9].{2,}", driver.page_source).group()}'

if __name__ == "__main__":

How to integrate proxies with Selenium using Java?

The following contains complete code demonstrating how Oxylabs proxies can be integrated with Selenium using Java.


Download and install Maven, Java SE Development Kit, and Google Chrome.


To make the process easier, let’s use BrowserMob Proxy as a middle layer. It runs proxies locally in JVM and allows the chaining of authenticated proxies. If you’re using Maven, add this dependency to the pom.xml file:


Another library for the project, Selenium WebDriverManager, is optional. It makes downloading and setting up ChromeDriver easier. To use this library, include the following dependency in the pom.xml file:


Alternatively, to avoid using WebDriverManager, download ChromeDriver and set the system property as follows:


Compiling the source code

This is a Maven project. To compile the project, run the following command from the terminal:

mvn clean package

This will create the file in the target folder.

Running the JAR

To run the JAR, execute the following command from the terminal:

java -cp target/ ProxyDemo

Proxy authentication

Open the file and update your username, password, and endpoint with your Oxylabs proxies credentials:

static final String ENDPOINT="";
static final String USERNAME="yourUsername";
static final String PASSWORD="yourPassword";

You shouldn’t include the prefix customer- in the USERNAME. This will be added to the code for country-specific proxies.

Testing proxy connection

Open the project in an IDE, open the file, and run the main() function. Doing so will return two IP addresses:

  1. A random IP address.

  2. A country-specific IP address.

Getting a country-specific proxy

Open the file and send a two-letter country code to the CountrySpecificIPDemo function:


The value of this parameter is a case-insensitive country code in two-letter 3166-1 alpha-2 format. For example, DE for Germany, FR for France, etc. Check Oxylabs documentation for more details.

SSL support

The code uses BrowserMob Proxy, which supports full MITM. However, you may still see invalid certificate warnings. To solve this, install the ca-certificate-rsa.cer file in your browser or HTTP client. Alternatively, you can generate your own private key rather than using the .cer files distributed with the repository.

Installation certificate for macOS

  1. Navigate to Keychain Access > System > Certificates (click the padlock icon next to System and enter your password when prompted).

  2. Drag and drop the ca-certificate-rsa.cer file into the Certificates tab. A new certificate named LittleProxy MITM will appear.

3. Right-click the certificate and select Get Info.

4. Select Always Trust, close the dialog, and enter the password again when promoted.

Installation certificate for Windows

  1. Open the ca-certificate-rsa.cer file in Windows Explorer.

  2. Right-click the file and select Install.

  3. In the Certificate Import Wizard window, click Browse, select Trusted Publishers, and click OK to continue.

4. If you see a Security Warning, select Yes.

5. Follow the wizard to complete the installation.

Understanding the code

The complexity of setting up BrowserMob Proxy and Chrome Options is hidden in the ProxyHelper class. In most cases, you should be able to use this file directly without any changes.

To create a ChromeDriver instance, go through a two-step process. First, create an instance of BrowserMobProxyServer. This is where you need to provide the proxy endpoint, username, and password.

The fourth parameter is a two-letter country code. If you don’t need a country-specific proxy, set it to null:

BrowserMobProxyServer proxy=ProxyHelper.getProxy(

Next, call the ProxyHelper.getDriver() function. This function takes two parameters -BrowserMobProxyServer and a boolean headless. To run the browser in headless mode, send true:

WebDriver driver=ProxyHelper.getDriver(proxy,true);

driver is an instance of ChromeDriver. Now, you should write your code to use the ChromeDriver. Before exiting, remember to close the driver and stop the proxy:


Wrapping it up

Selenium is a serviceable tool for web scraping, especially when learning the basics. With the help of Oxylabs proxies, web scraping is considerably more efficient.

If you have any questions about integrating Oxylabs proxies, you can contact us anytime. You should also visit our GitHub profile for the raw code and more integration tutorials.

Please be aware that this is a third-party tool not owned or controlled by Oxylabs. Each third-party provider is responsible for its own software and services. Consequently, Oxylabs will have no liability or responsibility to you regarding those services. Please carefully review the third party's policies and practices and/or conduct due diligence before accessing or using third-party services.

Get the latest news from data gathering world

I'm interested

Get Selenium proxies for $15/GB