search docs

Data collection with DevTools

Learn how to use browser DevTools, CSS selectors, and JavaScript to collect data from a website.

We know the basics of HTML, CSS, JavaScript and DevTools and we can finally try doing something more practical - collecting data from a website. Let's try collecting the 50 most popular websites in the world from the Alexa Top Sites index. We will use CSS selectors, JavaScript, and DevTools to do that.

Getting structured data from HTML

When you open the Alexa Top Sites index, you'll see that there's a table on the page with names of websites and various data about the websites' traffic. We will now learn how to collect all this information. Open DevTools and select the first website - in our case - with the selector tool.

Selecting an element with DevTools

Now you know where to find the name of the first website in the page's HTML, but we want to find all information about this first website. To do that, in the Elements tab, hover over the elements above the one you just found, until you find the element that contains all the data about the selected website. Alternatively, you can press the up arrow a few times to get the same result.

Selecting an element from the Elements tab

This element is the parent element of all the nested (child) elements and we can find it using JavaScript and collect the data. Notice the class attribute of the element. This is where CSS selectors become handy, because we can use them to select an element with a specific class.

Websites change and the structure or their HTML or the CSS selectors can become outdated. We'll try our best to keep this tutorial updated, but if you find that what you see on the website doesn't match this guide exactly, don't worry. Everything will work exactly the same. You will only have to use whatever you see on your screen and not in the screenshots here.

Selecting elements with JavaScript

We know how to find an element manually using the DevTools, but for automated scraping, we need to tell the computer how to find it as well. We can do that using JavaScript and CSS selectors.

The function to do that is called document.querySelector('some-selector') and it will find the first element in the page's HTML matching the provided CSS selector. For example document.querySelector('div') will find the first <div> element. And document.querySelector('') will find the first <p> element with the class my-class.

You can find available CSS selectors and their syntax on the MDN CSS Selectors page.

At the time of writing, the HTML element that contained all the data we wanted had a <div> tag and a tr site-listing class. This actually means that there were two classes applied to the element. tr and site-listing. The site-listing class looked like the more reliable pick for targeting the element so we chose that one. We ran this command in the DevTools Console to select the element we wanted.


Query a selector with JavaScript

There are always multiple ways to select an element using CSS selectors. We always try to choose the one that seems the most reliable, precise, and unlikely to change with website updates. For example the site-listing class looks like the website's programmers deliberately put it there to signify one result and we therefore think it's the best to use.

Collecting data from elements

Now that we found the element, we can start poking into it to collect data. First, let's save the element to a variable so that we can work with it repeatedly and then print its text content to the console.

const item = document.querySelector('');

Print text content of an element

As you can see, we were able to collect the data, but the format is still not very useful. For further processing, for example in a spreadsheet, we would like to have each piece of data as a separate field (column). To do that, we will look at the HTML structure in more detail.

Selecting child elements

In the Getting structured data from HTML section, we were hovering over the elements in the Elements tab to find the element that contains all the data. We can use that to find the individual data points as well. After a bit of inspection, we find that all the elements with the data we need are div with the class td.

Don't forget that the selectors may have changed from div and td, but the general principle of finding them will always be the same. Use what you see on your screen.

Finding child elements in Elements tab

The document.querySelector() function looks for a specific element in the whole HTML document, so if we called it with, it would find the first <div class="td ..."> in the document. Luckily we can also use this function to look for elements within an element.

There's even a similar function called querySelectorAll() that returns an array of all the elements matching the selector, not only the first one. We will use that function to get all the fields with data.

Learn more about Arrays in this tutorial.

Don't forget that earlier we saved the parent element into a variable called item. We can use that variable to search only within that element.

const fields = item.querySelectorAll('');

List child elements with JavaScript

Collecting data

The fields array now contains all the elements we need and we can access the data individually. Let's save the results into an object. Those of you who know JavaScript will know that this is not the prettiest code ever written, but it is beginner-friendly and that's important here. We will also use the .trim() function to remove unnecessary whitespace from the results.

const result = {
    rank: fields[0].textContent.trim(),
    site: fields[1].textContent.trim(),
    dailyTimeOnSite: fields[2].textContent.trim(),
    dailyPageViews: fields[3].textContent.trim(),
    percentFromSearch: fields[4].textContent.trim(),
    totalLinkingSites: fields[5].textContent.trim(),

Print collected data to the Console

If you were able to get the same result in your browser console, congratulations! You successfully collected your first data. If not, don't worry and review your code carefully. You'll crush the bug soon enough.

Next up

We have learned how to collect information of a single website from the Alexa Top Sites index. In the next chapter, we will learn how to collect all of it.