Parsing HTML pages in Android using Jsoup with a practical example

This post describes how to use JSoup in Android to parse HTML.  JSoup is a Java library that helps us to extract and manipulate HTML file. Using this library we can parse HTML pages in Android.
There are some situations when we want to parse and extract information from an HTML page instead of rendering it. In this case, we can integrate JSoup with Android because it has a set of powerful API very easy to use. In this post, we will discuss how to set up an Android project that uses JSoup and how to extract information from an HTML page developing an Android app.

If you prefer to download the Android app to test it you can download it from Github:

Parsing HTML in Android: JSoup introduction

JSoup library is a Java library providing a set of API to extract and manipulate HTML files. There are several methods to read and parse an HTML page. Let us suppose, we have an HTML page on a remote server and we want to retrieve it.  Therefore, it is necessary to provide an URL. If we want to parse the page as DOM, we have:

Document doc  = Jsoup.connect(URL).get();

where doc is an instance of Document class that holds the document retrieved. Now we have our representation of the document and we are free to extract information. We can retrieve the title or other information using the HTML tags.

For example, if we want to get all the tag named meta, we have:

Elements metaElems ="meta");

where select is the method to use when we want to get tags using CSS-query. For example, if we want to retrieve the attribute value from a tag we have:

String name = metaElem.attr("name");

where the name is the attribute name. Moreover, we can select all the elements in an HTML page that have a specific CSS class value. For example, in this website, there are some elements that have a CSS class equals to ‘topic’, so we have:

Elements topicList ="h2.topic");

where we select just the h2 tag having a class named topic.

If you want to have more information follow this link.

Setup the project and integrate JSoup in Android Studio

The first thing, we have to do is creating a standard Android project in Android Studio that contains a simple Activity, I will assume you are using Android Studio to do it. Once your project is ready, we have to add the JSoup dependency. So open build.gradle file, in Android Studio IDE, and in the dependency section add:

[xml]compile ‘org.jsoup:jsoup:1.11.2′[/xml]

so we have:

[plain]dependencies {
compile fileTree(dir: ‘libs’, include: [‘*.jar’])
compile ‘’
compile ‘org.jsoup:jsoup:1.11.2’

Now we are ready to use JSoup API and parsing HTML.

[bctt tweet=”Parse HTML page in Android #androiddev” username=”survivingwithan”]

Creating the Android app that parses HTML page with JSoup

Once we know some basic information about JSoup API, we can start coding our Android app. At the end we will obtain:

how to use JSoup with Android to parse HTML pages

The first thing to have in mind is that we are calling a remote website, so we can’t use our JSoup API in the main thread otherwise we could have ANR problems, so in this example, we will use an AsyncTask.

As you can see the layout is very simple: we have an EditText to insert the URL, a button to lunch the HTML parsing and another EditText to show the results. In the main activity we have:

protected void onCreate(Bundle savedInstanceState) {

final EditText edtUrl = (EditText) findViewById(;
Button btnGo = (Button) findViewById(;
respText = (EditText) findViewById(;
btnGo.setOnClickListener(new View.OnClickListener() {
public void onClick(View view) {
String siteUrl = edtUrl.getText().toString();
(new ParseURL() ).execute(new String[]{siteUrl});

where ParseURL is the class in charge of parsing the HTML file using JSoup. Now in this class, we have:

[java] private class ParseURL extends AsyncTask<String, Void, String> {

protected String doInBackground(String… strings) {
StringBuffer buffer = new StringBuffer();
try {
Log.d(“JSwa”, “Connecting to [“+strings[0]+”]”);
Document doc = Jsoup.connect(strings[0]).get();
Log.d(“JSwa”, “Connected to [“+strings[0]+”]”);
// Get document (HTML page) title
String title = doc.title();
Log.d(“JSwA”, “Title [“+title+”]”);
buffer.append(“Title: ” + title + “rn”);

// Get meta info
Elements metaElems =“meta”);
buffer.append(“META DATArn”);
for (Element metaElem : metaElems) {
String name = metaElem.attr(“name”);
String content = metaElem.attr(“content”);
buffer.append(“name [“+name+”] – content [“+content+”] rn”);

Elements topicList =“h2.topic”);
buffer.append(“Topic listrn”);
for (Element topic : topicList) {
String data = topic.text();
buffer.append(“Data [“+data+”] rn”);
catch(Throwable t) {
return buffer.toString();

protected void onPostExecute(String s) {

Analyzing this class at line 8 we connect to the remote URL and get the DOM representation of the HTML page. Then at line 11, we retrieve the page title. Using the information about JSoup introduced above, we start selecting the meta tags using the select method (line 16). We know there are several meta tags so we iterate over them and retrieve name and content attribute (line 19-20). In the last part, we select all the HTML tags having a class equals to topic and iterate over it extracting the text content.

How to integrate JSoup and Volley to retrieve the HTML page

In the example above we used AsyncTask to do the work in the background, but if you prefer you can use volley too. In this case, we will parse the document not using an URL but a String containing the doc retrieved:

[java] StringRequest req = new StringRequest(Request.Method.GET, url,
new Response.Listener<String>() {
public void onResponse(String data) {
Document doc = Jsoup.parse(data);
new Response.ErrorListener() {
public void onErrorResponse(VolleyError volleyError) {
// Handle error

At the end of this tutorial, hopefully, you know how to develop an Android app integrated with Jsoup to parse HTML pages.

    1. Wiem Rachman September 2, 2014
    2. Sandeep Gupta October 31, 2014
    3. survivingwithandroid November 4, 2014
    4. Ashwani Kumar April 27, 2015
    5. Francis Rodrigues August 17, 2016
    6. mazi September 11, 2016

    Add Your Comment