Web Scraping with Selenium and Beautiful Soup

Jisha Obukwelu
Apr 27 · 7 min read

— web scraping greatschools.org

Summary: This article dives into the nitty, gritty of my first experience web scraping a greatschools.org, a dynamic website. I delve into the libraries used and the packages necessary for using Selenium and Beautiful Soup. As a burgeoning, data scientist, web scraping is very much essential in data science field. I hope this article piques your curiosity.

Photo by Jisha Obukwelu


For 8 weeks (part-time), I worked as a data scientist and machine learning engineer on a remote interdisciplinary team. We were tasked with building CitySpire 2.0, an application that is a one-stop resource for users to receive the most accurate city information.

The data science team took a completely analytical approach to finding apartments within cities. This application is prescriptive in nature, helping users to find suitable places. One feature that I worked on was integrating information about school districts and their ratings.

School information is a very big factor when people/families decide on moving to a new city. To find relevant school information, I went to greatschools.org.

What is Web Scraping?

Since great schools did not have an accessible API, I had to scrape the school data for the cities in our CitySpire database.

What is web scraping? Why do it?

Web scraping is the extraction of data from a website. This information is collected and then exported into a user friendly format. I created a schools listing endpoint that delivered schools information based on grade levels (prekindergarten, elementary, middle school, or high school).

Great Schools

Great schools has a Summary Rating scale that is based on a 1–10 scale, where 10 is the highest and 1 is the lowest. Ratings of 1–4 signal that school is “below average”, 5–6, indicate “average”, and 7–10 are “above average” or “high performing”.

The Summary Rating calculation is based on four ratings, designed to show different facets of school success: the Student Progress Rating or Academic Progress Rating, College Readiness Rating, Equity Rating, and Test Score Rating. The ratings for each school vary based on data availability or relevance to a school level (for example, high schools have a College Readiness Rating, but elementary schools do not). Summary Ratings are not produced for schools if they lack sufficient data.


Image of greatschools.org table for New York, NY. https://www.greatschools.org/new-york/new-york/schools/

I do not have much experience working with web scraping, so my first attempt was with with Beautiful Soup.

Beautiful Soup

Beautiful Soup is a Python library for getting data out of HTML, XML, and other markup languages. Beautiful Soup helps you pull particular content from a webpage, remove the HTML markup, and save the information. It is a tool for web scraping that helps you clean up and parse the documents you have pulled down from the web. You can look for specific HTML tags.

Image of html tags revealed after inspecting the web page.

When I implemented this code, it yielded an empty array.


Upon further investigation, I saw that this was a dynamic web page with the table generated using JavaScript. After some research of other Python based web scraping packages, I came across Selenium. The Selenium package is used to automate web browser interaction from Python. With Selenium, programming a Python script to automate a web browser is possible. Using Selenium, I was able to easily parse the JavaScript.

Selenium starts a browser session. For Selenium to work, it must access the browser driver. By default, it will look in the same directory as the Python script. Links to Chrome, Firefox, Edge, and Safari drivers are available here. For my project I used Chrome.

Scraping greatschools.org using selenium

This was definitely a more promising start. I was able to return the following table. Below are the results from this code.

The resulting dataframe from just using selenium.
Results from using Selenium to scrape greatschools.org

Some Things Just Go Better Together

The table above showed that I was on the right track. Just looking further at the School column, there were several pieces of information that were all together and not easy to split using regex (believe me, I tried).

A closer look at the `schools` column that was generated from web scraping with selenium.
School column had several things included in one column
Looking at the schools row and all the data inside that one cell -> school name, address, school score, and school rating.
row school contains — school score and rating, name, address.

After several trial and errors, I was able to create loop that used Selenium to access the web page and Beautiful Soup to parse the information in the School column.

Data Extraction and Cleaning


To run both Selenium and Beautiful Soup several packages need to be installed.


1. pipenv install selenium

2. Selenium needs a web driver (the browser it automates). I chose Chrome.

To read more, you can go to Selenium’s documentation.

Beautiful Soup for extracting data:

  1. pipenv install bs4
  2. pipenv install requests
Image from stack abuse article https://stackabuse.com/guide-to-parsing-html-with-beautifulsoup-in-python/. Shows image of soup finding html tags and extracting text/info from the web page.

Using Beautiful Soup allowed me to parse the School column, to extract the different elements inside the school row on greatschools.org.

HTML Description:

These are the common HTML elements that I looked for with Beautiful Soup.

  1. The <table> tag is used to render data in the form of a table. <td> for columns, and <tr> is for rows.
  2. <div> is used as a container to represent an area on the screen.
  3. <a> defines a hyperlink.

4. To get the specific row, column, container, etc. you will then specify the class, to parse out the data you are trying to retrieve.

Example:soup.find(‘div’, {‘class’: ‘circle-rating — small’})

Image to parse specific elements from a web page.
Finding all instances of a specific HTML tag.

So, Where’s the Code?

If you are like me, you are probably be thinking “This is all well and good, but where is the code?” So not to disappoint, this is the code that I used to scrape greatschools.org (They have recently created a free public API to interact with their site and to retrieve data to use for your own personal projects. ).

  1. The current CitySpire application has data for 374 cities. I created a csv formatting the cities that I needed to extract school information.
used city list spreadsheet and a state abbreviations dictionary to generate this newly formatted cities list

2. Below is the code that I used to get the schools information for the respective cities.

I will break this large chunk of code down.

driver = webdriver.Chrome() This opened up the Chrome browser that what used to parse greatschool’s dynamic site.

— Since, each city has a different number of schools, I could not set a specific page number so I utilized the pagination-summary.

while loop that continues to incrementally scrape greatschools

This while loop continues to increase the page number if the total number of schools has not been reached.

This what the pagination summary looks like:

Image of pagination summary. It says “Showing 1 to 25 of 1,109 schools found in New York, NY”
pagination summary text
This is the html formatting of the pagination summary.
pagination summary HTML

Using regex, I separated the pagination summary as a list, and then retrieved the third item (ending number) and the fifth item (total number) of the list, and compared the two numbers. If the ending number is equal to or greater than the total number, this will break the loop.

— The last part of the code, utilizes Beautiful Soup to parse the elements of the table.

this code parses the table and then appends the info to it’s own record.


I hope you enjoyed this article! This was actually a deep dive for me into something that I have not had experience with. Selenium is often necessary to extract data from websites using lots of JavaScript and with Beautiful Soup, you can easily parse information using the HTML tags. I had a lot of fun working with Selenium and Beautiful Soup and diving into the documentation.

Resulting csv, using Selenium and Beautiful Soup.
Resulting dataframe from web scraping

There is still so much for me to learn. I know that my above code is not perfect, I am sure that my while loop could be better. I also learned that I could have done this with just Selenium or just Beautiful Soup but this duet made navigating the page easier for my first time.

Going Further

There was more cleaning and feature engineering that I had to do to create the finalized schools.csv and two endpoints that serve schools related data.


Finalized schools.csv after cleaning and feature engineering. This shows a cleaned address column and 4 additional columns, separating schools into prekindergarten, elementary, middle school, and high school.
finalized school.csv -> cleaned address column, categorized schools from pre-k to high school

Schools Listing Endpoint:

schools endpoint returns a list of schools based on users desired city and school category

School Summary Endpoint:

returns total schools, number of private, public, charter, and percentage of highly performing schools


To learn more, you can follow the below links:

— To learn more about web scraping, you can go here.

— To see how I cleaned the table, you can go here.

— To see the schools.csv, you find it here.

— To see how I created categorized pickled dictionaries, you can go here.(This was for faster look up. The csv has >65K rows.)

— To see how I summarized the school info, you can go here.

— You can find the schools_listing endpoint here and the school summary, endpoint here.

Nerd For Tech

From Confusion to Clarification

Nerd For Tech

NFT is an Educational Media House. Our mission is to bring the invaluable knowledge and experiences of experts from all over the world to the novice. To know more about us, visit https://www.nerdfortech.org/. Don’t forget to check out Ask-NFT, a mentorship ecosystem we’ve started

Jisha Obukwelu

Written by

Data Science student at Lambda School

Nerd For Tech

NFT is an Educational Media House. Our mission is to bring the invaluable knowledge and experiences of experts from all over the world to the novice. To know more about us, visit https://www.nerdfortech.org/. Don’t forget to check out Ask-NFT, a mentorship ecosystem we’ve started

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store