"# jsoup: Java HTML Parser **jsoup** is a Java library for working with real-world HTML. It provides a very convenient API for extracting and manipulating data, using the best of DOM, CSS, and jquery-like methods. **jsoup** implements the [WHATWG HTML5](http://whatwg.org/html) specification, and parses HTML to the same DOM as modern browsers do. * scrape and [parse](https://jsoup.org/cookbook/input/parse-document-from-string) HTML from a URL, file, or string * find and [extract data](https://jsoup.org/cookbook/extracting-data/selector-syntax), using DOM traversal or CSS selectors * manipulate the [HTML elements](https://jsoup.org/cookbook/modifying-data/set-html), attributes, and text * [clean](https://jsoup.org/cookbook/cleaning-html/whitelist-sanitizer) user-submitted content against a safe white-list, to prevent XSS attacks * output tidy HTML jsoup is designed to deal with all varieties of HTML found in the wild; from pristine and validating, to invalid tag-soup; jsoup will create a sensible parse tree. See [**jsoup.org**](https://jsoup.org/) for downloads and the full [API documentation](https://jsoup.org/apidocs/). ## Example Fetch the [Wikipedia](http://en.wikipedia.org/wiki/Main_Page) homepage, parse it to a [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Introduction), and select the headlines from the *In the News* section into a list of [Elements](https://jsoup.org/apidocs/index.html?org/jsoup/select/Elements.html) ([online sample](https://try.jsoup.org/~LGB7rk_atM2roavV0d-czMt3J_g), [full source](https://github.com/jhy/jsoup/blob/master/src/main/java/org/jsoup/examples/Wikipedia.java)): ```java Document doc = Jsoup.connect("http://en.wikipedia.org/").get(); log(doc.title()); Elements newsHeadlines = doc.select("#mp-itn b a"); for (Element headline : newsHeadlines) { log("%s\n\t%s", headline.attr("title"), headline.absUrl("href")); } ``` ## Open source jsoup is an open source project distributed under the liberal [MIT license](https://jsoup.org/license). The source code is available at [GitHub](https://github.com/jhy/jsoup/tree/master/src/main/java/org/jsoup). ## Getting started 1. [Download](https://jsoup.org/download) the latest jsoup jar (or add it to your Maven/Gradle build) 2. Read the [cookbook](https://jsoup.org/cookbook/) 3. Enjoy! ## Development and support If you have any questions on how to use jsoup, or have ideas for future development, please get in touch via the [mailing list](https://jsoup.org/discussion). If you find any issues, please file a [bug](https://jsoup.org/bugs) after checking for duplicates. The [colophon](https://jsoup.org/colophon) talks about the history of and tools used to build jsoup. ## Status jsoup is in general, stable release." (Indicator: "https://") "* scrape and [parse](https://jsoup.org/cookbook/input/parse-document-from-string) HTML from a URL, file, or string" (Indicator: "https://") "* find and [extract data](https://jsoup.org/cookbook/extracting-data/selector-syntax), using DOM traversal or CSS selectors" (Indicator: "https://") "* manipulate the [HTML elements](https://jsoup.org/cookbook/modifying-data/set-html), attributes, and text" (Indicator: "https://") "* [clean](https://jsoup.org/cookbook/cleaning-html/whitelist-sanitizer) user-submitted content against a safe white-list, to prevent XSS attacks" (Indicator: "https://") "See [**jsoup.org**](https://jsoup.org/) for downloads and the full [API documentation](https://jsoup.org/apidocs/)." (Indicator: "https://") "Fetch the [Wikipedia](http://en.wikipedia.org/wiki/Main_Page) homepage, parse it to a [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Introduction), and select the headlines from the *In the News* section into a list of [Elements](https://jsoup.org/apidocs/index.html?org/jsoup/select/Elements.html) ([online sample](https://try.jsoup.org/~LGB7rk_atM2roavV0d-czMt3J_g), [full source](https://github.com/jhy/jsoup/blob/master/src/main/java/org/jsoup/examples/Wikipedia.java)):" (Indicator: "https://") "jsoup is an open source project distributed under the liberal [MIT license](https://jsoup.org/license). The source code is available at [GitHub](https://github.com/jhy/jsoup/tree/master/src/main/java/org/jsoup)." (Indicator: "https://") "1. [Download](https://jsoup.org/download) the latest jsoup jar (or add it to your Maven/Gradle build)" (Indicator: "https://") "2. Read the [cookbook](https://jsoup.org/cookbook/)" (Indicator: "https://") "If you have any questions on how to use jsoup, or have ideas for future development, please get in touch via the [mailing list](https://jsoup.org/discussion)." (Indicator: "https://") "If you find any issues, please file a [bug](https://jsoup.org/bugs) after checking for duplicates." (Indicator: "https://") "The [colophon](https://jsoup.org/colophon) talks about the history of and tools used to build jsoup." (Indicator: "https://") "jsoup changelog *** Release 1.11.3 [PENDING] * Improvement: CDATA sections are now treated as whitespace preserving (regardless of the containing element), and are round-tripped into output HTML. * Improvement: added support for Deflate encoding. * Improvement: when parsing