Skip to content


BSD-2-Clause 24 2 767
184 (month) Mar 02 2013 3.5.4(3 years ago)
2,988 4 63 Apache-2.0
Jul 17 2019 431.5 thousand (month) 1.9.0(a month ago)

Essence is a simple PHP library to extract media information from websites, like youtube videos, twitter statuses or blog articles.

Trafilatura is a Python package and command-line tool designed to gather text on the Web. It includes discovery, extraction and text processing components. Its main applications are web crawling, downloads, scraping, and extraction of main texts, metadata and comments. It aims at staying handy and modular: no database is required, the output can be converted to various commonly used formats.

Going from raw HTML to essential parts can alleviate many problems related to text quality, first by avoiding the noise caused by recurring elements (headers, footers, links/blogroll etc.) and second by including information such as author and date in order to make sense of the data. The extractor tries to strike a balance between limiting noise (precision) and including all valid parts (recall). It also has to be robust and reasonably fast, it runs in production on millions of documents.

This tool can be useful for quantitative research in corpus linguistics, natural language processing, computational social science and beyond: it is relevant to anyone interested in data science, information extraction, text mining, and scraping-intensive use cases like search engine optimization, business analytics or information security.

Example Use

$Essence = new Essence\Essence();
$Media = $Essence->extract('');

// will result in array of values:
// type
// version
// url
// title
// description
// authorName
// authorUrl
// providerName
// providerUrl
// cacheAge
// thumbnailUrl
// thumbnailWidth
// thumbnailHeight
// html
// width
// height
# it can be used to clean HTML files
from trafilatura import clean_html

html = '<html><head><title>My Title</title></head><body><p>This is some <b>bold</b> text.</p></body></html>'
cleaned_html = clean_html(html)

# can strip away tags:
clean_html(html, tags_to_remove=["title"])
# or attributes
clean_html(html, attributes_to_remove=["title"])

Alternatives / Similar

Was this page helpful?