jsoup HTML parser hello world examples
Jsoup, a HTML parser, its “jquery-like” and “regex” selector syntax is very easy to use and flexible enough to get whatever you want. Below are three examples to show you how to use Jsoup to get links, images, page title and “div” element content from a HTML page.
Download jsoup
The jsoup is available in Maven central repository. For non-Maven user, just download it from jsoup website.
<dependency>
<groupId>org.jsoup</groupId>
<artifactId>jsoup</artifactId>
<version>1.10.2</version>
</dependency>
1. Grabs All Hyperlinks
This example shows you how to use jsoup to get page’s title and grabs all links from “google.com”.
package com.mkyong;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;
import java.io.IOException;
public class HTMLParserExample1 {
public static void main(String[] args) {
Document doc;
try {
// need http protocol
doc = Jsoup.connect("http://google.com").get();
// get page title
String title = doc.title();
System.out.println("title : " + title);
// get all links
Elements links = doc.select("a[href]");
for (Element link : links) {
// get the value from href attribute
System.out.println("\nlink : " + link.attr("href"));
System.out.println("text : " + link.text());
}
} catch (IOException e) {
e.printStackTrace();
}
}
}
Output
title : Google link : http://www.google.com.my/imghp?hl=en&tab=wi text : Images link : http://maps.google.com.my/maps?hl=en&tab=wl text : Maps //omitted for readability
It’s recommended to specify a “
userAgent
” in Jsoup, to avoid HTTP 403 error messages.
Document doc = Jsoup.connect("http://anyurl.com")
.userAgent("Mozilla")
.get();
2. Grabs All Images
The second example shows you how to use the Jsoup regex selector to grab all image files (png, jpg, gif) from “yahoo.com”.
package com.mkyong;
package com.mkyong;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;
import java.io.IOException;
public class HTMLParserExample2 {
public static void main(String[] args) {
Document doc;
try {
//get all images
doc = Jsoup.connect("http://yahoo.com").get();
Elements images = doc.select("img[src~=(?i)\\.(png|jpe?g|gif)]");
for (Element image : images) {
System.out.println("\nsrc : " + image.attr("src"));
System.out.println("height : " + image.attr("height"));
System.out.println("width : " + image.attr("width"));
System.out.println("alt : " + image.attr("alt"));
}
} catch (IOException e) {
e.printStackTrace();
}
}
}
Output
src : http://l.yimg.com/a/i/mntl/ww/events/p.gif height : 50 width : 202 alt : Yahoo! src : http://l.yimg.com/a/i/ww/met/intl_flag_icons/20111011/my_flag.gif height : width : alt : //omitted for readability
3. Get Meta elements
The last example simulates an offline HTML page and use jsoup to parse the content. It grabs the “meta” keyword and description, and also the div element with the id of “color”.
package com.mkyong;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
public class HTMLParserExample3 {
public static void main(String[] args) {
StringBuffer html = new StringBuffer();
html.append("<!DOCTYPE html>");
html.append("<html lang=\"en\">");
html.append("<head>");
html.append("<meta charset=\"UTF-8\" />");
html.append("<title>Hollywood Life</title>");
html.append("<meta name=\"description\" content=\"The latest entertainment news\" />");
html.append("<meta name=\"keywords\" content=\"hollywood gossip, hollywood news\" />");
html.append("</head>");
html.append("<body>");
html.append("<div id='color'>This is red</div> />");
html.append("</body>");
html.append("</html>");
Document doc = Jsoup.parse(html.toString());
//get meta description content
String description = doc.select("meta[name=description]").get(0).attr("content");
System.out.println("Meta description : " + description);
//get meta keyword content
String keywords = doc.select("meta[name=keywords]").first().attr("content");
System.out.println("Meta keyword : " + keywords);
String color1 = doc.getElementById("color").text();
String color2 = doc.select("div#color").get(0).text();
System.out.println(color1);
System.out.println(color2);
}
}
Output
Meta description : The latest entertainment news
Meta keyword : hollywood gossip, hollywood news
This is red
This is red
4. Grabs Form Inputs
This code snippets shows you how to use Jsoup to grab HTML form inputs (name and value). For detail usage, please refer to this automate login a website with Java.
public void getFormParams(String html){
Document doc = Jsoup.parse(html);
//HTML form id
Element loginform = doc.getElementById("your_form_id");
Elements inputElements = loginform.getElementsByTag("input");
List<String> paramList = new ArrayList<String>();
for (Element inputElement : inputElements) {
String key = inputElement.attr("name");
String value = inputElement.attr("value");
}
}
5. Get Fav Icon
This code shows you how to use Jsoup to page’s favourite icon.
package com.mkyong;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
public class jSoupExample {
public static void main(String[] args) {
StringBuffer html = new StringBuffer();
html.append("<html lang=\"en\">");
html.append("<head>");
html.append("<link rel=\"icon\" href=\"http://example.com/image.ico\" />");
//html.append("<meta content=\"/images/google_favicon_128.png\" itemprop=\"image\">");
html.append("</head>");
html.append("<body>");
html.append("something");
html.append("</body>");
html.append("</html>");
Document doc = Jsoup.parse(html.toString());
String fav = "";
Element element = doc.head().select("link[href~=.*\\.(ico|png)]").first();
if(element==null){
element = doc.head().select("meta[itemprop=image]").first();
if(element!=null){
fav = element.attr("content");
}
}else{
fav = element.attr("href");
}
System.out.println(fav);
}
}
Output
http://example.com/image.ico
I got following error when i try to run
$java HTMLParserExample1
Exception in thread “main” java.lang.NoClassDefFoundError: org/jsoup/Jsoup
at HTMLParserExample1.main(HTMLParserExample1.java:16)
Caused by: java.lang.ClassNotFoundException: org.jsoup.Jsoup
at java.net.URLClassLoader$1.run(URLClassLoader.java:202)
at java.security.AccessController.doPrivileged(Native Method)
at java.net.URLClassLoader.findClass(URLClassLoader.java:190)
at java.lang.ClassLoader.loadClass(ClassLoader.java:306)
at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:301)
at java.lang.ClassLoader.loadClass(ClassLoader.java:247)
… 1 more
Your’re missing some library. I had the same problem and I had to download this:
http://www.java2s.com/Code/Jar/h/Downloadhttpmime401jar.html
Go to http://jsoup.org/packages/jsoup-1.7.3.jar
download the jar file, and put the jar file into your project library
Check your classpath
you can find some more details in the below link<"http://javadomain.in/parsing-title-of-the-website-using-jsoup/"
Great explanations with simple examples
Having 1 doubt there are some pages where I am unable to fetch the links and page title even though there are multiple links and title is present is it due to some security issues.
sir i have done a sample program in jsoup but i got an error like
Exception in thread “main” java.net.UnknownHostException: http://www.google.com
at java.net.AbstractPlainSocketImpl.connect(Unknown Source)
at java.net.PlainSocketImpl.connect(Unknown Source)
at java.net.SocksSocketImpl.connect(Unknown Source)
at java.net.Socket.connect(Unknown Source)
at sun.security.ssl.SSLSocketImpl.connect(Unknown Source)
at sun.net.NetworkClient.doConnect(Unknown Source)
at sun.net.www.http.HttpClient.openServer(Unknown Source)
at sun.net.www.http.HttpClient.openServer(Unknown Sour……………..
sir can u pls help me on this
Thanks in advance
sir can you explain jsoup using download wepage plain text and sublink contain plain text also write a output in to individual text file the text file name should be linkname ….
Neat!!! I am sharing it.
I am new to Jsoup and wanted to know why Jsoup shows an error when called inside a Servlet. I am stuck in the problem from arround 20 days no answer till yet.
is there a way to Parse a PDF file – I have a PDF which has an internal link. I want to parse the link from the PDF
when i run i got
HTTP Status 404 –
type Status report
message
description The requested resource () is not available.
Apache Tomcat/6.0.18
….
Please help me on this
Sir, what if i want to get text that is untagged? Please reply soon.
Hi! I’m getting this error: “Exception: java.lang.reflect.InvocationTargetException Message: java.lang.reflect.InvocationTargetException” I’ve googled but nothing works for me
Respected Sir,
how do i connect Https using Jsoup????
I tried to extract an image from other websites with the following code and i had no problems, but them i tried with other website and nothing happend. no image came up.
protected Void doInBackground(Void… params) {
try {
// Connect to the web site
Document document = Jsoup.connect(https://www.indiegogo.com/project/spy-cam-peek-i/embedded).get();
// Using Elements to get the class data
Elements img = document.select(“div.i-project-card i-embedded img[src]”);
// Locate the src attribute
String imgSrc = img.attr(“src”);
//Download image from URL
InputStream input = new java.net.URL(imgSrc).openStream();
// Decode Bitmap
bitmap = BitmapFactory.decodeStream(input);
} catch (IOException e) {
e.printStackTrace();
}
return null;
}
Your examples are clean, go to the essential and easy to grasp. Thanks for your commitment!
Hi can you please tell me how I could extract the text and erase everything else.
In 4. Grabs Form Inputs what is “List paramList = new ArrayList();” used for? I don’t see it being used in your code snippet.
Can you please tell me how to download PDF or DOC etc files from web pages using jsoup??
Hi,
How can I retrieve all the data within the td’s.
For example:6:05
Thanks
I assume you would use the method getElementsByTagName()
Hi,
how to retrieve font-family from below code snippet .
body{font-family:Arial, Helvetica, sans-serif;font-size:12pt;padding:0;margin:0;}
please help me out on this.
thanks, nicky
Please help out me, I tried HTMLParserExample1 as its in the above code
But getting,
java.net.SocketTimeoutException: connect timed out
at java.net.PlainSocketImpl.socketConnect(Native Method)
Code:
public static void main(String[] args) {
Document doc;
try {
doc = Jsoup.connect(“http://google.com”).get();
String title = doc.title();
System.out.println(“title : ” + title);
Elements links = doc.select(“a[href]”);
for (Element link : links) {
System.out.println(“\nlink : ” + link.attr(“href”));
System.out.println(“text : ” + link.text());
}
}
System.getProperties().put(“proxySet”, “true”);
System.getProperties().put(“proxyHost”, “host”);
System.getProperties().put(“proxyPort”, “port”);
Add these lines, when use a proxy to approach Internet.
that worked… thanks
Nice tutorials for JSoup do you have any examples of how can i fetch each and every information resides in each link, something like a web crawling for Jsoup.
Hi,
I need to write a parser which will parse through a jsp page and find a list of specific tags. I tried using SAXParser but getting a lot of exceptions. Can you please suggest me some solutions??
Really nice tutorial for beginners
Thanks Alot!!!
hello mkyong,
I ran the first example (grab all hyperlinks) but came across java.net.ConnectException: Connection refused: connect error.Is there any way to resolve it?
great tutorial clear all my query’s about jsoup thanxxx sirr thanxx a lot.
Another useful example; thanks again to mkyong!
I almost feel bad pointing this out but just for other n00bs out there like me, I believe “doc2” in your HTMLParserExample2.java should be “doc”
Current line:
New line:
http://cp27.web.id/showthread.php?tid=1642
I agree that JSoup is great.
I’m working with it and amazed that MKyong covered it.
Thanks!
The best as always! Thank you for your excellent example! This api could be valuable for testing web apps as well!
It also seems to work on JSPs and JSP 2 tag files without much trouble.
really nice example