How to Select Elements by Attribute Value in XPath?

As a web scraper, being able to accurately target elements on a page is critical to extracting the data you need. While CSS selectors are commonly used for web scraping, XPath offers some powerful advantages when selecting elements by attributes and their values.

In this comprehensive guide, you'll learn how to leverage XPath to precisely match element attribute values for robust web scraping.

Introduction to XPath

XPath (XML Path Language) is a query language for selecting nodes from an XML or HTML document. Some key features include:

  • Traversing XML/HTML structure to precisely target elements
  • Flexible syntax for matching text, attributes, structure, etc.
  • Browser developer tools support interactively testing XPath
  • Widespread usage in web scraping tools and libraries

While CSS selectors are limited to class, ID, and element names, XPath allows matching elements based on any attribute value using flexible expressions. This makes XPath invaluable for scraping semi-structured data, where attribute values may provide the context needed to extract the right data.

Selecting Elements by Exact Attribute Value

The basic syntax for selecting elements by an attribute value in XPath is:


This will match all elements where the specified attribute exactly equals the value inside the quotes.

Some examples:

<!-- Select input with name "email" -->

<!-- Select anchors with href="contact.html" -->  

The surrounding double quotes allow you to match strings with spaces as well:

<!-- Select button with class "btn btn-primary" -->
//button[@class="btn btn-primary"]

You can also select multiple attributes in the same predicate filter:

//input[@type="email" and @name="email"]

This makes XPath queries extremely precise for targeting elements with specific attributes.

Using contains() for Partial Matching

XPath also provides the contains() function to select elements where the attribute value contains a specific substring:

[contains(@attribute, "substring")]

Some examples:

<!-- Select anchors containing "product" in @href -->
//a[contains(@href, "product")]

<!-- Select inputs containing "user" in class -->
//input[contains(@class, "user")]

This allows more flexible matching where you may not know the full attribute value.

Selecting One of Multiple Attribute Values

Another common need is selecting elements where the attribute matches one of several possible values. The or operator | can be used to combine multiple attribute filters:

[contains(@class, "user") or contains(@class, "login")]

This will select elements that match either condition.

Some more examples:

<!-- Select anchors with href ending .html or .htm -->
//a[contains(@href, ".html") or contains(@href, ".htm")]

<!-- Select inputs of type email, tel or number -->  
//input[@type="email" or @type="tel" or @type="number"]

This provides the flexibility to target elements matching any of the specified attribute values.

Additional Tips and Tricks

Beyond the basics, there are some additional handy techniques for attribute matching in XPath:

  • starts-with() – Select elements where attribute starts with a value
  • @* – Select elements that have a specific attribute, regardless of its value
  • sort() – Sort selected elements by attribute value
  • position() – Select by numerical position filtered by attribute
  • and / or – Combine multiple attribute filters

Refer to the XPath syntax reference for more operators and functions.

Why Use XPath Over CSS Selectors?

While CSS selectors are limited to targeting by class, ID and element, XPath allows:

  • Matching any attribute value, not just class/ID
  • Partial matching with contains()
  • Logical and / or combinations
  • Additional functions like starts-with()sort(), etc.

This power and flexibility makes XPath an essential part of any web scraper's toolbox when dealing with complex, semi-structured sites.

Real-World Web Scraping Examples

Let's walk through some real-world examples using XPath and the ScrapingBee web scraping API:

Example 1: Scrape Amazon product listings

import scrapingbee
client = scrapingbee.ScrapingBeeClient('YOUR_API_KEY') 

# Get HTML of Amazon search results
url = ''
html = client.get_html(url)  

# Extract product listings using data-asin attribute
products = html.xpath('//div[@data-component-type="s-search-result"]/@data-asin')


This will output all the Amazon Standard Identification Numbers (ASINs) for laptop listings, allowing you to extract each product.

Example 2: Scrape eBay sold listings

html = client.get_html('')

# Find sold listings containing "Sold" in the class  
sales = html.xpath('//li[contains(@class,"s-item") and contains(., "Sold")]')

for item in sales:
   name = item.xpath('.//h3[@class="s-item__title"]/text()')
   price = item.xpath('.//span[@class="s-item__price"]/text()')
   print(name, price)

This prints the name and sold price of all iPhones sold on eBay.

Common Gotchas

While XPath is powerful, here are some common mistakes to avoid:

  • Forgetting the @ symbol when matching attributes
  • Using double instead of single quotes for string values
  • Not escaping special characters like quotes or apostrophes
  • Confusing XPath index starting at 1 vs. programming languages starting at 0

Refer to the element inspector tooltips and syntax guides to avoid simple syntax issues.

Best Practices

To effectively leverage XPath for scraping, keep these best practices in mind:

  • Start with simple selectors and build up complexity gradually
  • Use the browser inspector to test and refine XPath selectors interactively
  • Prefer id and class attributes if they are unique and consistent
  • Combine multiple filters for uniqueness when needed
  • Index positions often change – avoid if possible
  • Double check for mismatches and test edge cases
  • Use APIs like ScrapingBee for large-scale scraping to avoid headaches

Adopting a methodical approach to crafting XPath selectors will ensure reliable attribute matching.

When to Use XPath vs. CSS Selectors

Both XPath and CSS have their place in a web scraper's toolkit:

  • XPath – Best for matching attributes, textual content, partial matches
  • CSS – Simpler syntax for classes, IDs and hierarchy

In general, use:

  • CSS selectors for simple class and ID matching
  • XPath when you need to filter elements by attributes or text

Many scraping tools support both, so you can mix and match as needed.


XPath offers indispensable features for matching elements by attributes for more robust web scraping. When combined with other scraping best practices, XPath attribute selection helps ensure your scraper reliably extracts the right data. To handle large scraping projects without headaches, leveraging a web scraping API service like ScrapingBee is highly recommended.

I hope this guide provides a solid grasp of how to leverage XPath for your next web scraping project.

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)