Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Your preferred open source focused crawler for the Deep Web.

Maven Central Build Status Coverage Status Javadoc


Our aim is to create a blazing fast, fully customizable and robust crawler that is simple and handy to use.

Quick links

Website | API Reference | Wiki | Examples | Tutorial | PreferredAI


  • Multi-threaded out of the box
  • Structured crawling with JSoup integration
  • Page Validation
  • Automatic Retries
  • Proxy support
  • Auto-save raw html pages

Getting started

Getting started with Venom is quick and easy. There are two ways to get started.

Clone our examples or tutorial

If you are starting out in a new project, you can consider cloning our Examples:

git clone

or, if you would like a more guided package, you can check out our Tutorial:

git clone

Add a dependency

If you already have a project then just add Venom as a dependency to your pom.xml:

    <!-- Venom: Your preferred focused crawler @ -->


If you are new to Venom, we have created a set of exercises to get you up and sprinting. The exercises are bundled in venom-tutorials. More information can be found on this page.


If you would like more information check out our Wiki.


Think you are beyond exercises? Get started quickly with these few lines of code.

public class Example {
    private static class VenomHandler implements Handler {
        public void handle(Request request,
                           VResponse response,
                           Scheduler scheduler,
                           Session session,
                           Worker worker) {
            String about = response.getJsoup().select(".sub-title b").text();
            System.out.println("ABOUT: " + about);
    public static void main(String[] args) throws Exception {
        try (Crawler c = Crawler.buildDefault().start()) {
            Request r = new VRequest("");
            c.getScheduler().add(r, new VenomHandler());


Apache License 2.0