orange3-ilpost 0.1.0

Orange3 widget for fetching articles from Il Post

Orange3 Il Post Widget

An Orange3 add-on widget for fetching articles, podcasts, and newsletters from the Italian online newspaper Il Post. The widget queries the Il Post search API and outputs a Corpus ready for text mining workflows.

User Interface

Installation

pip install orange3-ilpost

The package requires Orange3 and orange3-text to be installed. The Il Post API wrapper (ilpost-api-wrapper) is installed automatically as a dependency.

Usage

After installation, the Il Post category will appear in the Orange Canvas widget toolbox.

1. Drag the Il Post widget onto the canvas.
2. Type a search query in the Query field and press Enter or click Search.
3. Adjust the filters as needed (see below).
4. Connect the widget output to any text mining widget (e.g. Corpus Viewer, Word Cloud, Topic Modelling).

Controls

Control	Description
Query	Search term. Keeps a history of recent queries.
Content type	Filter by All, Articles, Podcasts, or Newsletters.
Date range	Filter by All time, Past year, or Past 30 days.
Sort by	Sort results by Relevance, Newest, or Oldest.
Category	Optional editorial category filter (e.g. politica, cultura). Applies to articles only.
Max documents	Maximum number of results to retrieve (10–1000).
Include paywalled content	When unchecked, subscriber-only results are excluded.
Text includes	Choose which fields are used as text features for analysis: Title, Summary, Highlight, Category, Tags.

Output

The widget outputs a Corpus with the following metadata columns:

Field	Type	Description
Title	String	Article/episode title
Summary	String	Short description
Highlight	String	Search snippet with matched terms
Category	String	Editorial category
Tags	String	Comma-separated topic tags
Type	String	Content type (post, episodes, newsletter)
Publication Date	Time	Publication timestamp (Italian local time)
URL	String	Link to the full content
Relevance Score	Continuous	Search relevance score (0.0 when sorted by date)

Example workflow

[Il Post] → [Corpus Viewer]
[Il Post] → [Word Cloud]
[Il Post] → [Topic Modelling]
[Il Post] → [Sentiment Analysis]

Requirements

• Python 3.9+
• Orange3
• orange3-text
• ilpost-api-wrapper

License

MIT