How to Use XPath Selectors in Python?

As a web scraping expert with over 5 years of experience, most of my projects involve Python and leveraging proxies to access web data at scale. In this comprehensive guide, I'll share my top techniques for using XPath selectors within your Python web scrapers to target the content you need precisely.

What is XPath and Why Use It for Web Scraping?

XPath stands for XML Path Language. It's a query language for selecting nodes from an XML or HTML document. Some key abilities provided by XPath include:

  • Navigating to specific elements by tag name, attributes, text content, and more
  • Searching recursively across the entire DOM structure
  • Advanced functionality like conditions, wildcard matches, and more

This makes XPath perfect for writing robust web scrapers. You can precisely target the data you want to extract, eliminating the fragility of relying on DOM positions alone.

Python Libraries That Support XPath

Several Python libraries have XPath support baked in:

  • lxml¬†– The most popular and powerful library for processing XML and HTML. Our scraping scripts will primarily leverage lxml and its xpath() method.
  • parsel¬†– A Scrapy-focused library that uses lxml under the hood but provides some nicer abstractions.
  • Scrapy Selectors¬†– Part of the Scrapy web scraping framework. Also powered by lxml.
  • Beautiful Soup¬†– Primarily for HTML parsing. More limited XPath support than lxml but very developer-friendly.

For the examples in this guide, we'll focus specifically on usage with lxml and parsel, which I've found to be the most relevant for most real-world scraping projects.

Fundamental XPath Syntax and Query Structure

Learning XPath does involve getting familiar with a special query dialect. Fortunately, many of the conventions will feel quite familiar for those with experience using CSS selectors. Some examples of basic XPath patterns:

  • //p¬†– Find all paragraph tags recursively
  • /html/body/div¬†– Sequentially traverse document hierarchy
  • //a[@href='link']¬†– Search¬†<a>¬†tags with specific href
  • (//table)[1]¬†– Index into list of tables, selecting first

This is just a small sample of what's possible but showcases some common usage idioms:

  • Double slashes to search globally Across DOM
  • Single slashes to explicitly follow structure
  • []¬†brackets to apply filtering conditions

One major difference from CSS is that everything in XPath relates to the document structure vs styles, layout, etc. This emphasis on semantics is what makes it so appropriate for scraping. With those basics in mind, let's now see XPath selections in action within Python scrapers.

Using XPath With lxml

The lxml library provides an xpath() method we can use for selections against an parsed document:

from lxml import html

doc = html.fromstring("""  
  <p>Paragraph 1</p> 
  <p>Paragraph 2</p>

p_elements = doc.xpath("//p")  
# Paragraph 1

Some key pointers when using XPath with lxml:

  • The xpath() method returns a¬†list¬†of matching elements
  • We can then work with these elements using properties like¬†.text

This makes lxml extremely flexible for both pinpoint data selection and large scale automated extraction.

Finding Dynamic Content

A major challenge in real-world scraping is dealing with the prevalence of dynamic JavaScript. An XPath query that works on page load may fail after DOM changes post load. We can account for minor variations using contains():

results = doc.xpath("//div[contains(@class, 'results')]")

This will robustly match all <div> tags that have a class containing “results”.

Working With Returned Elements

Beyond just getting text content, we can also extract attributes and work with the selected elements:

urls = []
for a in doc.xpath("//a"):

We iterated the <a> elements, and used the .get() method to grab the href attribute from each. These examples demonstrate core usage, but parsel and Scrapy Selectors work quite similarly in terms of XPath API.

Now let's look at…

Scraping With parsel Selectors

The parsel library built atop lxml provides an alternative Selector interface with integrated XPath support:

from parsel import Selector  

selector = Selector(text='''
 <p>Paragraph 1</p>
 <p>Paragraph 2</p>  

# ['<p>Paragraph 1</p>', '<p>Paragraph 2</p>']

Some things to note when using parsel:

  • The¬†.getall()¬†method returns a list of raw markup
  • Everything stays as strings avoiding¬†.text¬†callsOverall API feels more integrated vs lxml's separate parsing


acting Attributes

In addition to text content, extracting attributes is a common need:

# ['first.html', 'second.html']

The @href syntax returns just the attribute value instead of full elements.

Why I Prefer Parsel Over lxml

While lxml is more full-featured, parsel offers:

  • Cleaner syntax
  • Better string handling
  • Tighter integration with Scrapy ecosystem

So I typically reach for parsel by default for most scraping scripts.

Robust XPath Query Writing Tactics

While the basics like searching by tag or attributes often suffice, XPath offers far richer syntax for advanced queries. Let's explore some key features…

Advanced Axes, Functions and Operators

Recursive Search// looks globally across all document children:


Wildcards* matches any element type:


Boolean Logic – Operators like and/or allow conditions:

//div[@class="results" and @data-test]

Mathematicalsum()/count() for calculations:


Stringcontains(), starts-with() etc work on text:

//p[contains(., "introduction")]

Example Implementations

Let's look at some examples utilizing advanced features:

Relative Searching

for result in response.xpath("//product"):
   title = result.xpath(".//h3/text()").get()
   # Search within .// context

Position Indexing

response.xpath("(//h2)[1]").get() # First h2




response.xpath("//a[starts-with(@href, '/category')]")


response.xpath("//a[starts-with(@href, '/category')]")

I encourage becoming familiar with the full range of expressions available. It enables creating far more targeted queries.

Proxy Integration for Successful Data Harvesting

When scraping commercial sites programmatically, using proxies is essential to avoid blocks. Some reputable proxy services I'd recommend are:

ProviderUse CasePerformanceStabilityCost
Bright DataGeneral PurposeExcellentReliableStart at $500
SoaxResidential IPsVery GoodDecentStart at $99
SmartproxyBackconnect RotatingGoodVariableStart at $14+

Implementation in Python

We can directly integrate proxies using the requests library:

import requests
proxy = "http://user:[email protected]:8000"  
requests.get("", proxies={"http": proxy})

For large-scale scraping, utilizing provider APIs avoids proxy burnout.

Additional Resources for Leveling Up

To recap, here are some useful resources for continuing to master XPath:

I hope you've found this detailed guide on leveraging XPath for Python web scraping helpful! Please feel free to reach out if you have any other questions.

John Rooney

John Rooney

John Watson Rooney, a self-taught Python developer and content creator with a focus on web scraping, APIs, and automation. I love sharing my knowledge and expertise through my YouTube channel, My channel caters to all levels of developers, from beginners looking to get started in web scraping to experienced programmers seeking to advance their skills with modern techniques. I have worked in the e-commerce sector for many years, gaining extensive real-world experience in data handling, API integrations, and project management. I am passionate about teaching others and simplifying complex concepts to make them more accessible to a wider audience. In addition to my YouTube channel, I also maintain a personal website where I share my coding projects and other related content.

We will be happy to hear your thoughts

      Leave a reply

      Compare items
      • Total (0)