[scrape, webscraping, internet, beautifulsoup, website]


While it’s easy to get started with Beautifulsoup, it has limitations when it comes to dynamic websites. That is, websites of which the content changes after each page refresh. Selenium can handle both static and dynamic websites and mimic user behavior (e.g., scrolling, clicking, logging in). It launches another web browser window in which all actions are visible which makes it feel more intuitive. Here we outline the basic commands and installation instructions to get you started.



Finding content in a website’s source code

Running the code snippet below starts a new Google Chrome browser (driver) and then navigates to the specified URL. In other words, you can follow along with what the computer does behind the screens. Next, you can obtain specific website elements by tag name (e.g., h1 is a header) similar to BeautifulSoup.

import selenium.webdriver

driver = selenium.webdriver.Chrome()

# retrieve first H1 header

The first time you will need to (1) install the Python package for Selenium, (2) download a web driver to interface with a web browser, and (3) configure Selenium to recognize your web driver.

  1. Open Anaconda Prompt (Windows) or the Terminal (Mac), type the command conda install selenium, and agree to whatever the package manager wants to install or update (usually by pressing y to confirm your choice).
  2. Once we run the scraper, a Chrome browser launches which requires a web driver executable file. Download this file from here (open this site in Chrome to identify your current Chrome version).
  3. Unzip the file and move it to the same directory where you’re running this notebook. Either you can set a chrome_path manually (e.g., /Users/Pieter/Documents/webscraping/chromedriver) or ideally you make Chromedriver available through a so-called PATH variable so that you can access it regardless of your current directory. To do so, …
    • Windows users can follow the steps described here. If that doesn’t work for you, this guide may help.
    • Mac users need to move the chromedriver file to the /usr/local/bin folder. cd to the directory of the chromedriver file and type mv chromedriver /usr/local/bin.


Alternatively, you can specify which elements to extract through attributes, classes and identifiers:

# HTML classes

# HTML identifiers ()

# XPath


Within Google Inspector you can easily obtain the XPath by right-clicking on an element and selecting: “Copy” > “Copy XPath”.

User interactions

One of the distinguishable features of Selenium is the ability to mimic user interactions which can be vital to get to the data you are after. For example, older tweets are only loaded once you scroll down the page.

# scroll down the page
driver.execute_script('window.scrollTo(0, document.body.scrollHeight);')

# click on element (e.g., button)
element_to_be_clicked = driver.find_element_by_class_name("<CLASS_NAME>")

Advanced Use Case

Task Scheduling

See the building block on task automation on how to schedule the execution of the web scraper (e.g., every day). Keep in mind that this only works with Python scripts, so if you’re currently working in a Jupyter Notebook you need to transform it into .py file first.

See Also

  • Looking for a simple solution that does the job without any bells and whistles? Try out the BeautifulSoup package and review this complementary building block.