Discover / Data & Research

Heritrix

by internetarchiveJava

Extensible archival quality web crawler used by the Internet Archive.

Toolstable

Maturity: stable because 15y old, 3.16.0 released 31d ago. Derived from release and commit history, not a rating.

Stars
3.3k
Forks
792
Downloads / mo
Last commit
2026-08-01
License
NOASSERTION
Open issues
36

Market and trust evidence

Edition not yet matched

No exact skills.sh identity match is available for this repository. Repository adoption and freshness remain visible above; install momentum is not inferred.

Trust analysis is a screening signal, not a security warranty. Read the ranking and trust methodology.

In practice

Written by AI from this repository’s README · medium confidence

Archiving whole sites at scale with preservation quality output rather than one off scraped text.

Use it when

Use it when the goal is a durable web archive with politeness controls and robots.txt compliance.

Not the right pick when

Heavyweight and Java based, and the README leaves all setup to external documentation.

Capabilities

  • web-scale archival-quality crawling
  • respects robots.txt and META nofollow tags
  • configurable politeness policies per crawl
  • crawl jobs configured through bean references
  • REST API for operating the crawler

Cost: Free and open source

What the repository ships

Has docsSecurity policyCI configured

Detected from the actual files in the repository root.

Latest release 3.16.0

Published 2026-07-03

Download distribution zip (or tar.gz)

Full Changelog | Javadoc | Maven Central

Distribution packages moved to GitHub releases

Due to recently introduced size limits, the Heritrix distribution packages (-dist.zip and -dist.tar.gz) can no longer be published to Maven Central. Instead, they will be made available on the GitHub release page.

The individual module binary, Javadoc, and source JARs will continue to be published to Maven Central.

New features

  • PaginationBehavior: Added a new behavior for BrowserProcessor that repeatedly clicks the "next-page" link and extracts links, enabling crawling of client-side paginated sites. #736

Bug fixes

  • BrowserProcessor: #742
  • Improved subresource request failure handling.
  • Implemented recording truncation based on length and timeout limits.
  • Fixed content digest calculation for subresources.
  • Ensured the User-Agent header is set correctly for browser requests.
  • Handle WebDriver BiDi Cookie.sameSite value default.
  • Fixed a bug in where POST requests were recorded with doubled headers and trailing nulls. #737
  • Error logging: The exception is now logged when creating a new job fails.
  • Groovy default profile: Removed a stray closing brace }.

Dependency upgrades

  • amqp-client: 5.30.0 → 5.33.0
  • central-publishing-maven-plugin: 0.10.0 → 0.11.0
  • dnsjava: 3.6.4 → 3.6.5
  • groovy-bom: 5.0.5 → 5.0.6
  • jackson-bom: 2.21.3 → 2.22.0
  • jaxb-runtime: 4.0.7 → 4.0.9
  • jetty (jetty-bom, jetty-ee10-bom): 12.0.34 → 12.0.36
  • jsch: 2.28.2 → 2.28.3
  • junit-jupiter: 6.0.3 → 6.1.1
  • kafka-clients: 4.2.0 → 4.3.1
  • maven-surefire-plugin: 3.5.5 → 3.5.6
  • slf4j-bom: 2.0.17 → 2.0.18
  • spring (spring-beans, spring-context, spring-core, spring-expression): 7.0.7 → 7.0.8

Tags

README

Heritrix

Maven Central Version

Docker

Javadoc

LICENSE

Introduction

Heritrix is the Internet Archive's open-source, extensible, web-scale, archival-quality web crawler project. Heritrix (sometimes spelled heretrix, or misspelled or missaid as heratrix/heritix/heretix/heratix) is an archaic word for heiress (woman who inherits). Since our crawler seeks to collect and preserve the digital artifacts of our culture for the benefit of future researchers and generations, this name seemed apt.

Crawl Operators!

Heritrix is designed to respect the robots.txt exclusion directives and META nofollow tags. Please consider the

load your crawl will place on seed sites and set politeness policies accordingly. Also, always identify your crawl with contact information in the User-Agent so sites that may be adversely affected by your crawl can contact you or adapt their server behavior accordingly.

Documentation

Developer Documentation

Latest Releases

Information about releases can be found here.

License

Heritrix is free software; you can redistribute it and/or modify it under the terms of the Apache License, Version 2.0

Some individual source code files are subject to or offered under other licenses. See the included LICENSE.txt file for more information.

Heritrix is distributed with the libraries it depends upon. The libraries can be found under the lib directory in the release distribution, and are used under the terms of their respective licenses, which are included alongside the libraries in the lib directory.

Related tools