eventregistry

What it is and what it does

Event Registry is a Python client library for accessing the Event Registry news API, which aggregates articles and events from global news sources. It provides a query interface to search for news articles and events using a wide range of filters—keywords, named concepts (companies, people, places), news categories, sentiment scores, publication date ranges, source locations, and social media engagement metrics. The package handles API authentication, query construction, and result iteration, abstracting away direct HTTP calls to the underlying REST API.

The package is designed for researchers, data analysts, and developers who need programmatic access to structured news data. It supports both one-off queries and streaming feeds of new articles and events. However, the package is in abandoned maintenance status with no updates since June 2023, and it requires an API key obtained from the Event Registry service, which imposes both authentication overhead and potential rate limits or service availability concerns.

Use it for:

• Monitor news articles about specific companies or topics for sentiment analysis or trend tracking.
• Build a news aggregator that filters articles by location, category, and publication source.
• Research trending concepts and topics in the news over time using the trending API.
• Retrieve events related to keywords or concepts for event-driven data pipelines.
• Analyze social media engagement metrics for articles published by specific news sources.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Query news articles and events from Event Registry's API using filters like keywords, concepts, sentiment, location, date, and category.

Yes, if you need programmatic access to Event Registry's news data and can accept the abandoned maintenance status. The package is stable and has no known vulnerabilities, but verify that the Event Registry API service remains operational and that the package's Python 2.7 classifier does not reflect actual support limitations. High install friction and lack of recent updates are trade-offs for a specialized news API client.

Install

eventregistry on PyPI

pip install eventregistry

uv add eventregistry

poetry add eventregistry

Installing eventregistry

Before you install

High install friction due to source distribution format. Package is in abandoned maintenance status with no updates since June 2023, though the repository remains active with 260 stars.

License in practice

MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects.

Quickstart

pip install eventregistry

from eventregistry import EventRegistry, QueryArticlesIter
er = EventRegistry(apiKey="YOUR_API_KEY")
q = QueryArticlesIter(keywords="example")
for article in q.execQuery(er, maxItems=10):
    print(article)

Requires a free or paid API key from Event Registry (eventregistry.org) to authenticate queries.

Verify before relying

• Whether the package works with Python versions beyond 2.7 despite classifiers listing only 2.7.
• Current status of the Event Registry API service and whether it remains operational.
• Whether the abandoned maintenance status affects API compatibility or introduces breaking changes.

Package facts

Evidence: eventregistry-9.1.tar.gz

Tags

More Information Analysis packages