DEV Community

Lewis kori
Lewis kori

Posted on • Updated on • Originally published at

Introduction to web scraping with python

Originally published on my website

What is web scraping?

This is the process of extracting information from a webpage by taking advantage of patterns in the web page's underlying code.
We can use web scraping to gather unstructured data from the internet, process it, and store it in a structured format.
In this walkthrough, we'll be storing our data in a JSON file.

Alternatives to web scraping

Though web scraping is a useful tool in extracting data from a website,
it's not the only means to achieve this task.
Before starting to web scrape, find out if the page you seek to extract data from provides an API.

robots.txt file

Ensure that you check the robots.txt file of a website before making your scrapper. This file tells if the website allows scraping or if they do not.
To check for the file, simply type the base URL followed by "/robots.txt"
An example is, "".
For more about robots.txt files click here.

Other potential problems

Other problems one might encounter while web scraping is the possibility of your IP address being blacklisted. I partnered with scraper API, a startup specializing in strategies that'll ease the worry of your IP address from being blocked while web scraping. They utilize IP rotation so you can avoid detection. Boasting over 20 million IP addresses and unlimited bandwidth.

In addition to this, they provide CAPTCHA handling for you as well as enabling a headless browser so that you'll appear to be a real user and not get detected as a web scraper. For more on its usage, check out my post on web scraping with scrapy. Although you can use it with both BeautifulSoup and selenium.

Using this scraperapi link and the code
lewis10, you'll get a 10% discount off your first purchase!


Getting started

In this tutorial, we'll be extracting data from books to scrape
which you can use to practice your web scraping.
We'll extract the title, rating, link to more information about the book, and the cover image of the book.

Find the code on github.

1. Importing libraries

import requests
import json
from bs4 import BeautifulSoup
Enter fullscreen mode Exit fullscreen mode

The python libraries perform the following tasks.

  1. requests - will be used to make Http requests to the webpage.
  2. json - we'll use this to store the extracted information to a JSON file.
  3. BeautifulSoup - for parsing HTML.

2. walkthrough

header = {'User-Agent': 'Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv: Gecko/2009021910 Firefox/3.0.7'}

base_url = ""

r = requests.get(base_url,headers=header)
Enter fullscreen mode Exit fullscreen mode

We're initializing three variables here.

  1. header-HTTP headers provide additional parameters to HTTP transactions. By sending the appropriate HTTP headers, one can access the response data in a different format.

  2. base_url - is the webpage we want to scrape since we'll be needing the URL quite often, it's good to have a single initialization and reuse this variable going forward.

  3. r - this is the response object returned by the get method. Here, we pass the base_url and header as parameters.

if r.status_code == 200:
  soup = BeautifulSoup(r.text, 'html.parser')
  books = soup.find_all('li',attrs={"class":"col-xs-6 col-sm-4 col-md-3 col-lg-3"})
  for book in books:
    link=base_url +book.find('a')['href']
    stars = str(len(book.find_all('i',attrs=  {"class":"icon-star"}))) + " out of 5"
    picture = base_url + book.find('img')['src']
    single ={'title':title,'stars':stars,'price':price,'link':link,'picture':picture}
    with open('books.json','w') as f:
Enter fullscreen mode Exit fullscreen mode

To ensure our scraper runs when the HTTP response is ok we'll use the if statement as a check. The number 200 is the status code for Ok. To get a list of all codes and their meanings check out this resource.
We'll then parse the response object using the BeautifulSoup method and store the new object to a variable called soup.

From the aforementioned definition,

Web scraping the process of extracting information from a webpage by taking advantage of patterns in the web page's underlying code.

Let's take a look at a single record from our webpage to identify the patterns. Once we can see the page, we'll loop through every record on the page as they contain similar traits.
From the image above, we'll notice that all books are contained within a list item with the class

col-xs-6 col-sm-4 col-md-3 col-lg-3

By using the find_all() method, we can find all references of this HTML tag in the webpage. we pass the tag as the first argument and then using the attrs argument which takes in a python dictionary, we can specify attributes of the HTML tag selected. In this case, it was a class indicated above, but you can even use id as an attribute.

Store the result in a variable, I chose the name books.

link=base_url +book.find('a')['href']
Enter fullscreen mode Exit fullscreen mode

If we observe keenly, we'll notice that each of the elements we want to extract is nested within the list item tag are all contained in similar tags, in the example above. The title of the book is between h3 tags.
The find() method returns the first matching tag.
text will simply return any text found within the tags specified.
For the anchor tags, we'll be extracting the hyper reference link.
As opposed to the h3 tag, the href element is within anchor tags in HTML. Like so

<a href=""></a>

In this case, the returned object will behave like a dictionary where we have a


We do this iteratively for all the values we seek to extract because we are taking advantage of the pattern in the underlying code of the webpage. Hence the use of the python for loop.

single ={'title':title,'stars':stars,'price':price,'link':link,'picture':picture}
with open('books.json','w') as f:
Enter fullscreen mode Exit fullscreen mode

The extracted elements are then stored in respective variables which we'll put in a dictionary. With this information, we can then comfortably append the dictionary object to the initialized result list set before our for loop.

Finally, store the python list in a JSON file by the name "books.json" with an indent of 4 for readability purposes.

With that, you have your simple web scraper up and running. For more on web scrapers, read the documentation for the libraries or on youtube.

If you liked this walkthrough, subscribe to my mailing list to get notified whenever I make new posts.


Top comments (5)

Sloan, the sloth mascot
Comment deleted
lewiskori profile image
Lewis kori • Edited

Thanks for the message.
Your article was really well written and informative. I can honestly say
I've learnt a thing or two I didn't know about scrapy.

This post was actually part of a series. You'll find the scrapy part here though the approach I did was trying to explain how to navigate CAPTCHAs in websites and IP address blocking.

You can check that out as well and share your thougts on any issue.

zed_developer profile image

I really am liking BeautifulSoup having just recently started learning about it

lewiskori profile image
Lewis kori

It's interesting. Really simplifies web scraping even for beginners.
Continue playing around with it. I am too!
Always learning something new every day

Some comments may only be visible to logged-in visitors. Sign in to view all comments.