Skip to content

html5-parser

710 1 1 Apache-2.0
0.5.0 (20 Sep 2026) Jun 03 2007 16.1 thousand (month)

html5-parser is a Python library for parsing HTML and XML documents.

A fast implementation of the HTML 5 parsing spec for Python. Parsing is done in C using a variant of the gumbo parser. The gumbo parse tree is then transformed into an lxml tree, also in C, yielding parse times that can be a thirtieth of the html5lib parse times. That is a speedup of 30x. This differs, for instance, from the gumbo python bindings, where the initial parsing is done in C but the transformation into the final tree is done in python.

It is built on top of the popular lxml library and provides a simple and intuitive API for working with the document's structure.

html5-parser uses the HTML5 parsing algorithm, which is more lenient and forgiving than the traditional XML-based parsing algorithm. This means that it can parse HTML documents with malformed or missing tags and still produce a usable parse tree.

To use html5-parser, you first need to install it via pip by running pip install html5-parser. Once it is installed, you can use the html5_parser.parse() function to parse an HTML document and create a parse tree. For example:

from html5_parser import parse

html_string = "<html><body>Hello, World!</body></html>"
root = parse(html_string)
print(root.tag) # html
You can also use `html5_parser.parse()`` with file-like objects, bytes or file paths.

Once you have a parse tree, you can use the find() and findall() methods to search for elements in the document similar to BeautifulSoup.

html5-parser also supports searching using xpath, similar to lxml.

Example Use


from html5_parser import parse

html_string = "<html><body>Hello, World!</body></html>"
root = parse(html_string)
print(root.tag) # html
body = root.find("body")
# or find all
print(body.text) # "Hello, World!"
for el in root.findall("p"):
    print(el.text) # "Hello

Alternatives / Similar


3,074 6.1.3 (2026-09-02 14:46:05 ago) Dec 13 2022 compare
- 4.15.0 (2026-06-07 16:44:21 ago) Jul 26 2019 compare
5,758 1.0.4 (2026-02-22 02:21:21 ago) Jul 30 2007 compare
1,220 1.1 (2020-06-22 23:32:36 ago) Jul 30 2007 compare
313 1.6.0 (2026-10-09 20:05:08 ago) Apr 14 2012 compare
2,456 6.0.14 (2026-07-30 14:07:39 ago) Jun 15 2007 compare
1,715 1.0.2 (2026-10-22 15:43:09 ago) Mar 01 2018 compare
1,366 1.12.1 (2026-09-28 14:15:52 ago) Jul 26 2019 compare
102,927 0.5.1 (2026-11-04 20:29:38 ago) Aug 01 2024 compare
2,374 2.1.0 (2026-07-27 19:00:04 ago) Dec 05 2008 compare
13,798 0.10.0 (2019-02-17 20:14:17 ago) Feb 25 2018 compare
628 1.3.0 (2026-09-23 06:32:53 ago) Jun 09 2011 compare
220 1.4.1 (2026-05-17 22:07:23 ago) Jul 30 2007 compare
771 1.1 (2020-10-09 12:50:18 ago) Dec 28 2012 compare
23 0.6.0 (2023-04-26 10:16:25 ago) Jul 24 2014 compare

Other Languages

3,942 8.1.1 (2026-11-07 21:41:41 ago) Jul 03 2013 compare
21,754 31.0.1 (2026-11-13 06:36:48 ago) Nov 21 2011 compare
4,792 12.0.0 (2026-07-17 17:10:17 ago) Aug 28 2011 compare
1,157 1.6.1 (2026-07-24 18:50:24 ago) Feb 09 2011 compare
30,540 1.2.0 (2026-07-17 17:10:14 ago) Oct 08 2011 compare
6,288 1.19.7 (2026-11-02 18:22:56 ago) Jul 25 2009 compare
225 1.6.0 (2026-07-09 06:56:00 ago) Apr 20 2015 compare
1,791 2.12.0 (2026-10-25 08:57:58 ago) Jun 01 2013 compare
4,025 v8.2.0-BETA1 (2026-10-28 08:03:22 ago) Sep 26 2011 compare
1,525 1.0.5 (2026-07-09 06:54:00 ago) Nov 22 2014 compare
744 v1.3.9 (2026-10-05 05:37:06 ago) Jun 08 2019 compare
783 v1.3.7 (2026-10-05 06:05:48 ago) Feb 07 2019 compare
2,303 v2.0.2 (2026-08-01 14:25:37 ago) Apr 29 2017 compare
14,993 v1.13.0 (2026-08-27 13:20:59 ago) Aug 29 2016 compare
760 Start (2018-02-20 18:47:44 ago) Feb 20 2018 compare
2,141 v4.6.2 (2026-11-06 12:42:47 ago) Oct 26 2013 compare
- 2.0-RC2 (2019-11-09 15:42:50 ago) Nov 09 2019 compare
165 2.3.0 (2026-07-09 06:48:00 ago) Dec 22 2019 compare
Was this page helpful?